DXGKCB_NOTIFY_DPC callback function (d3dkmddi.h)

Article
02/22/2024

A kernel-mode display miniport driver calls DXGKCB_NOTIFY_DPC to inform the graphics processing unit (GPU) scheduler about a graphics hardware update at deferred procedure call (DPC) time.

Syntax

DXGKCB_NOTIFY_DPC DxgkcbNotifyDpc;

void DxgkcbNotifyDpc(
  [in] IN_CONST_HANDLE hAdapter
)
{...}

Parameters

[in] hAdapter

A handle to the adapter object for the GPU. The driver receives the handle from the DeviceHandle member of the DXGKRNL_INTERFACE structure in a call to its DxgkDdiStartDevice function.

Return value

None

Remarks

The display miniport driver's DPC callback routine calls DXGKCB_NOTIFY_DPC to inform the GPU scheduler about an update to a fence through a direct memory access (DMA) stream to the graphics hardware.

DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, call DxgkCbNotifyDpc via the DXGKRNL_INTERFACE.

Examples

The following code example shows how to notify the GPU scheduler about the DMA or V-Sync interrupt.

NTSTATUS
D3DDDINotifyDPC(
    HW_DEVICE_EXTENSION  *pAdapter)
{
    DXGKRNL_INTERFACE  *pCallback;
    DXGKCB_NOTIFY_DPC  DxgkCbNotifyDpc;

    pCallback = &(pAdapter->ddiCallback);

    if (! pAdapter->pVidSchDPCCB) {
        return (STATUS_SUCCESS);
    }

    DxgkCbNotifyDpc = (DXGKCB_NOTIFY_DPC)pAdapter->pVidSchDPCCB;

    DxgkCbNotifyDpc(pAdapter->DeviceHandle);

    return (STATUS_SUCCESS);
}

Requirements

Requirement	Value
Minimum supported client	Windows Vista (WDDM 1.0)
Target Platform	Desktop
Header	d3dkmddi.h (include D3dkmddi.h)
IRQL	DISPATCH_LEVEL