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 |