This topic has not yet been rated - Rate this topic

pfnCreateSynchronizationObject2Cb routine

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

C++


PFND3DDDI_CREATESYNCHRONIZATIONOBJECT2CB pfnCreateSynchronizationObject2Cb;

_Check_return_ HRESULT APIENTRY CALLBACK* pfnCreateSynchronizationObject2Cb(
  _In_     HANDLE hDevice,
  _Inout_  D3DDDICB_WAITFORSYNCHRONIZATIONOBJECT2 *pData
)
{ ... }

Parameters

hDevice [in]: A handle to the display device (that is, the graphics context) that will own the synchronization object that pfnCreateSynchronizationObject2Cb creates.
pData [in, out]: A pointer to a D3DDDICB_CREATESYNCHRONIZATIONOBJECT2 structure that describes the synchronization object to create.

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