PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMGPUCB callback function (d3dumddi.h)

Article
02/22/2024

pfnSignalSynchronizationObjectFromGpuCb is used to signal a monitored fence. When a particular graphics processing unit (GPU) engine is not capable of writing a new monitored fence value directly using its GPU virtual address, the driver needs to flush its command buffer and issue a signal from a GPU packet using pfnSignalSynchronizationObjectFromGpu2Cb. For Windows Display Driver Model (WDDM) v2 drivers, existing pfnSignalSynchronizationObjectCb and pfnSignalSynchronizationObject2Cb callbacks are deprecated and will eventually be removed. WDDM v2 user mode drivers should switch to pfnSignalSynchronizationObjectFromGpuCb, as it supports all synchronization object types.

Syntax

PFND3DDDI_SIGNALSYNCHRONIZATIONOBJECTFROMGPUCB Pfnd3dddiSignalsynchronizationobjectfromgpucb;

HRESULT Pfnd3dddiSignalsynchronizationobjectfromgpucb(
  HANDLE hDevice,
  const D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMGPU *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device.

unnamedParam2

pData [in]

A pointer to a D3DDDICB_SIGNALSYNCHRONIZATIONOBJECTFROMGPU 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

This function semantics are similar to existing pfnSignalSynchronizationObject2Cb call. In addition, the function supports monitored fence objects and an array of monitored fence values to signal.

Requirements

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