DWORD (APIENTRY *PDD_SURFCB_LOCK)(
PDD_LOCKDATA lpLock
);
Lock provides a valid pointer to a block of memory associated with a surface.
Parameters
lpLock
Pointer to a DD_LOCKDATA structure that contains the information required to perform the lockdown.
Return Value
Lock returns a DDHAL_DRIVER_Xxx callback code that indicates how the driver handled the call. These return codes are defined in ddrawint.h.
Comments
A driver should ensure that a blt or flip is not in progress before obtaining the memory pointer.
A lock does not provide exclusive access to the requested memory block; that is, multiple threads can lock the same surface at the same time. It is the application’s responsibility to synchronize access to the memory block whose pointer is being obtained.