PFND3DDDI_CREATESYNCHRONIZATIONOBJECT2CB callback function (d3dumddi.h)
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 *unnamedParam2
)
{...}
Parameters
hDevice
A handle to the display device (that is, the graphics context) that will own the synchronization object that pfnCreateSynchronizationObject2Cb creates.
unnamedParam2
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Minimum supported server | Windows Server 2012 |
| Target Platform | Desktop |
| Header | d3dumddi.h (include D3dumddi.h) |
See also
D3DDDICB_CREATESYNCHRONIZATIONOBJECT2
pfnDestroySynchronizationObjectCb