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 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL <=DISPATCH_LEVEL

另请参阅

DxgkDdiInterruptRoutine

KeSynchronizeExecution