DXGKCB_SYNCHRONIZE_EXECUTION callback function (dispmprt.h)

The DxgkCbSynchronizeExecution function synchronizes a specified function, implemented by the display miniport driver, with the display miniport driver's DxgkDdiInterruptRoutine function.

Syntax

DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;

NTSTATUS DxgkcbSynchronizeExecution(
  [in]  HANDLE DeviceHandle,
  [in]  PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
  [in]  PVOID Context,
  [in]  ULONG MessageNumber,
  [out] PBOOLEAN ReturnValue
)
{...}

Parameters

[in] DeviceHandle

A handle that represents a display adapter. The display miniport driver previously obtained this handle in the DeviceHandle member of the DXGKRNL_INTERFACE structure that was passed to DxgkDdiStartDevice.

[in] SynchronizeRoutine

A pointer to a function, implemented by the display miniport driver, that will be synchronized with DxgkDdiInterruptRoutine. The function must conform to the following prototype:

BOOLEAN SynchronizeRoutine(PVOID Context);

[in] Context

A pointer to a context block, created by the display miniport driver, that will be passed to SynchronizeRoutine.

[in] MessageNumber

The number of the interrupt message with which SynchronizeRoutine will be synchronized. If the interrupt is line-based, this parameter must be zero.

[out] ReturnValue

A pointer to a Boolean variable that receives the return value of SynchronizeRoutine.

Return value

DxgkCbSynchronizeExecution returns one of the following values:

Return code Description
STATUS_SUCCESS The function succeeded.
STATUS_INVALID_PARAMETER One of the parameters is invalid.
STATUS_UNSUCCESSFUL The function was unable to synchronize execution, possibly because the interrupt had not been connected yet.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Desktop
Header dispmprt.h (include Dispmprt.h)
IRQL <=DISPATCH_LEVEL

See also

DxgkDdiInterruptRoutine

KeSynchronizeExecution