DXGKCB_SYNCHRONIZE_EXECUTION回调函数 (dispmprt.h)
DxgkCbSynchronizeExecution 函数将显示微型端口驱动程序实现的指定函数与显示微型端口驱动程序的 DxgkDdiInterruptRoutine 函数同步。
语法
DXGKCB_SYNCHRONIZE_EXECUTION DxgkcbSynchronizeExecution;
NTSTATUS DxgkcbSynchronizeExecution(
[in] HANDLE DeviceHandle,
[in] PKSYNCHRONIZE_ROUTINE SynchronizeRoutine,
[in] PVOID Context,
[in] ULONG MessageNumber,
[out] PBOOLEAN ReturnValue
)
{...}
参数
[in] DeviceHandle
表示显示适配器的句柄。 显示微型端口驱动程序以前在传递给 DxgkDdiStartDevice 的 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员中获取此句柄。
[in] SynchronizeRoutine
指向由显示微型端口驱动程序实现的函数的指针，该函数将与 DxgkDdiInterruptRoutine 同步。 函数必须符合以下原型：
BOOLEAN SynchronizeRoutine(PVOID Context);
[in] Context
指向由显示微型端口驱动程序创建的上下文块的指针，该上下文块将传递给 SynchronizeRoutine。
[in] MessageNumber
用于同步 SynchronizeRoutine 的中断消息的编号。 如果中断是基于行的，则此参数必须为零。
[out] ReturnValue
指向接收 SynchronizeRoutine 返回值的布尔变量的指针。
返回值
DxgkCbSynchronizeExecution 返回以下值之一：
| 返回代码 | 说明 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| STATUS_INVALID_PARAMETER | 其中一个参数无效。 |
| STATUS_UNSUCCESSFUL | 函数无法同步执行，可能是因为中断尚未连接。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 目标平台 | 桌面 |
| 标头 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | <=DISPATCH_LEVEL |