Bink SDK 1.5v

BinkBufferUnlock

The function BinkBufferUnlock unlocks a BinkBuffer that has been locked with BinkBufferLock.

S32 BinkBufferUnlock(
  HBINKBUFFER bink_buf
);

In Parameters

bink_buf
Specifies the BinkBuffer handle.

Returns

Returns whether the BinkBuffer was successfully unlocked (non-zero) or not (zero).

Discussion

This function will unlock a locked BinkBuffer. You must unlock any BinkBuffers that you've locked with the BinkBufferLock function as quickly as possible. If you fail to unlock a BinkBuffer, DirectDraw will usually lock out your display and you'll have to reboot. Note that DirectDraw doesn't allow you to step through a DirectDraw lock, so never single step over a BinkBufferLock call, or your machine will lock up. Always set a breakpoint after the BinkBufferUnlock call, and then just run to the breakpoint.


Group: BinkBuffer API
Related Sections: Locking and Unlocking
Related Functions: BinkBufferBlit, BinkBufferLock, BinkBufferUnlock, BinkCopyToBuffer
Related Basic Types: BINKBUFFER_OPEN_FLAGS, HBINKBUFFER, S32
Related Structures: BINKBUFFER

For technical support, e-mail Bink1@radgametools.com
© Copyright 1994-2003 RAD Game Tools, Inc. All Rights Reserved.