PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMCPUCB callback function (d3dumddi.h)

Article
04/01/2021

pfnSignalSynchronizationObjectFromCpuCb enables a driver to signal a monitored fence.

Syntax

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMCPUCB Pfnd3dddiSignalsynchronizationobjectfromcpucb;

HRESULT Pfnd3dddiSignalsynchronizationobjectfromcpucb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMCPU *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device.

unnamedParam2

pData [in]

A pointer to a D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMCPU structure that provides the details of the requested operation.

Return value

If this callback function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When a monitored fence object is signaled by the CPU, the graphics kernel will update the fence memory location with the signaled value, so it becomes immediately visible to any user mode reader as well as immediately un-wait any satisfied waiters. However, the caller cannot assume that the signal operation will be completed upon the return from this function. Instead, the caller should use appropriate Wait functions to check for signal completion.

Note A signal from a graphics processing unit (GPU) call is not provided. Instead, a driver can signal a new fence value by inserting a GPU write command for FenceValueGPUVirtualAddress into a command buffer.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Desktop
Header	d3dumddi.h (include D3dumddi.h)

Share via