// dispmprt.h
DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;
NTSTATUS DxgkcbSynchronizeExecution(
[in] HANDLE DeviceHandle,
[in] PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
[in] PVOID Context,
[in] ULONG MessageNumber,
[out] PBOOLEAN ReturnValue
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The DxgkCbSynchronizeExecution function synchronizes a specified function, implemented by the display miniport driver, with the display miniport driver's DxgkDdiInterruptRoutine function.
DeviceHandle [in]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.
SynchronizeRoutine [in]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);
Context [in]A pointer to a context block, created by the display miniport driver, that will be passed to SynchronizeRoutine.
MessageNumber [in]The number of the interrupt message with which SynchronizeRoutine will be synchronized. If the interrupt is line-based, this parameter must be zero.
ReturnValue [out]A pointer to a Boolean variable that receives the return value of SynchronizeRoutine.
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. |