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	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	dispmprt.h (include Dispmprt.h)
IRQL	<=DISPATCH_LEVEL

See also

DxgkDdiInterruptRoutine

KeSynchronizeExecution