Edit

DXGKDDI_CANCELFLIPS callback function (d3dkmddi.h)

  • Article

In the hardware flip queue model, the OS calls a display miniport driver's DXGKDDI_CANCELFLIPS function to synchronously cancel previously queued flips.

Syntax

DXGKDDI_CANCELFLIPS DxgkddiCancelflips;

NTSTATUS DxgkddiCancelflips(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_CANCELFLIPS pCancelFlips
)
{...}

Parameters

hAdapter

[in] Handle to a display adapter.

pCancelFlips

[in/out] Pointer to a DXGKARG_CANCELFLIPS structure containing the parameters for this function.

Return value

DXGKDDI_CANCELFLIPS returns an NTSTATUS code such as one of the following:

Return value Meaning
STATUS_SUCCESS The routine completed successfully.
STATUS_NOT_IMPLEMENTED The driver does not implement support for this operation. For this return status, the OS will follow up with a call to DxgkDdiCancelQueuedFlips.

Remarks

Asynchronously cancelled PresentIds are reported via the VSync interrupt mechanism.

See Cancelling interlocked flips on multiple planes for more information.

Requirements

Requirement Value
Minimum supported client Windows 11 (WDDM 3.0)
Header d3dkmddi.h
IRQL DIRQL

See also

DXGKARG_CANCELFLIPS