PFND3DDDI_CREATESYNCHRONIZATIONOBJECT2CB callback function

Creates a GPU synchronization object that a device context can signal and wait for. Used by WDDM 1.2 and later user-mode display drivers.

Syntax

PFND3DDDI_CREATESYNCHRONIZATIONOBJECT2CB Pfnd3dddiCreatesynchronizationobject2cb;

HRESULT Pfnd3dddiCreatesynchronizationobject2cb(
  HANDLE hDevice,
  D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 *
)
{...}

Parameters

hDevice

A handle to the display device (that is, the graphics context) that will own the synchronization object that pfnCreateSynchronizationObject2Cb creates.

*

Return Value

Returns one of the following values:

Return code Description
S_OK
The synchronization object was successfully created.
E_OUTOFMEMORY
The function could not allocate memory that was required for it to complete.
E_INVALIDARG
Parameters were validated and determined to be incorrect.

This function might also return other HRESULT values.

Remarks

The pfnCreateSynchronizationObject2Cb function returns a kernel-mode handle to the newly created synchronization object in the hSyncObject member of the D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 structure that the pData parameter points to. The user-mode display driver passes this handle in calls to the following functions:

Requirements

   
Windows version Windows 8 Windows Server 2012
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See Also

D3DDDICB_CREATESYNCHRONIZATIONOBJECT2

D3DDDI_DEVICECALLBACKS

pfnDestroySynchronizationObjectCb

pfnSignalSynchronizationObject2Cb

pfnWaitForSynchronizationObject2Cb