pfnCreateSynchronizationObjectCb routine

The pfnCreateSynchronizationObjectCb function creates a synchronization object that a device context can signal and wait for.

Syntax


PFND3DDDI_CREATESYNCHRONIZATIONOBJECTCB pfnCreateSynchronizationObjectCb;

__checkResult HRESULT APIENTRY CALLBACK pfnCreateSynchronizationObjectCb(
  _In_     HANDLE hDevice,
  _Inout_  D3DDDICB_CREATESYNCHRONIZATIONOBJECT *pData
)
{ ... }

Parameters

hDevice [in]

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

pData [in, out]

A pointer to a D3DDDICB_CREATESYNCHRONIZATIONOBJECT structure that describes the synchronization object to create.

Return value

pfnCreateSynchronizationObjectCb returns one of the following values:

Return codeDescription
S_OK

The synchronization object was successfully created.

E_OUTOFMEMORY

pfnCreateSynchronizationObjectCb 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 pfnCreateSynchronizationObjectCb function returns a kernel-mode handle to the newly created synchronization object in the hSyncObject member of the D3DDDICB_CREATESYNCHRONIZATIONOBJECT structure that the pData parameter points to. The user-mode display driver passes this handle in calls to the following functions:

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDICB_CREATESYNCHRONIZATIONOBJECT
D3DDDI_DEVICECALLBACKS
pfnDestroySynchronizationObjectCb
pfnSignalSynchronizationObjectCb
pfnWaitForSynchronizationObjectCb

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft