PDD_SURFCB_UNLOCK callback function

아티클
10/17/2017
읽는 데 2분 걸림

The UnLockD3DBuffer callback function is used to release a lock held on a specified area of driver-managed buffer memory.

Syntax

PDD_SURFCB_UNLOCK UnlockD3DBuffer;

DWORD APIENTRY UnlockD3DBuffer(
   PDD_UNLOCKDATA lpUnlockD3DBuffer
)
{ ... }

Parameters

lpUnlockD3DBuffer
Points to a DD_UNLOCKDATA structure that contains the information required to perform the lock release.

Return value

UnLockD3DBuffer returns one of the following callback codes:

DDHAL_DRIVER_HANDLED

DDHAL_DRIVER_NOTHANDLED

Remarks

This callback is used only if the driver manages driver-level command and vertex buffers.

The driver does not need to verify that the memory was previously locked down by LockD3DBuffer, because Microsoft DirectDraw does parameter validation before calling UnLockD3DBuffer.

This call has the same prototype as the DdUnlock function. The UnLockD3DBuffer callback is used instead when the surface in question has the DDSCAPS_EXECUTEBUFFER flag set in the ddsCaps member of the DD_SURFACE_LOCAL structure.

UnLockD3DBuffer can be called with a disabled PDEV. A PDEV is disabled or enabled by calling the display driver's DrvAssertMode function. See Managing PDEVs for more information.

Requirements

Target platform	Desktop
Header	Ddrawint.h (include Winddi.h)