PMINIPORT_SYNCHRONIZE_ROUTINE回调函数 (video.h)

项目
02/29/2024

HwVidSynchronizeExecutionCallback 是一个可选的微型端口驱动程序函数，在对 VideoPortSynchronizeExecution 的调用中传递。

语法

PMINIPORT_SYNCHRONIZE_ROUTINE PminiportSynchronizeRoutine;

BOOLEAN PminiportSynchronizeRoutine(
  PVOID Context
)
{...}

参数

Context

指向通过 VideoPortSynchronizeExecution 传递到回调例程的上下文数据的指针。通常，这是指向设备扩展或设备扩展中的偏移量的指针。

返回值

如果操作成功， HwVidSynchronizeExecutionCallback 将返回 TRUE。

注解

具有一个或多个与其 HwVidInterrupt 函数共享内存的微型端口驱动程序必须具有 HwVidSynchronizeExecutionCallback 函数。与 HwVidInterrupt 共享内存的任何函数都必须使用 HwVidSynchronizeExecutionCallback 函数调用 VideoPortSynchronizeExecution，以维护共享内存区域中数据的完整性。也就是说，在任何给定时刻，只有一个 HwVidSynchronizeExecutionCallback 和 HwVidInterrupt 函数可以更新共享区域中的状态。

不生成中断的适配器的微型端口驱动程序也可以具有 HwVidSynchronizeExecutionCallback 函数，当此类驱动程序需要在相对较高的运行时优先级下完成一些关键工作时，将函数传递给 VideoPortSynchronizeExecution 。例如，VGA 兼容的微型端口驱动程序和 SvgaHwIoPortXxx 函数 (请参阅 SVGA Functions) 可能具有 HwVidSynchronizeExecutionCallback 函数，该函数负责将驱动程序缓冲和验证的应用程序颁发的 I/O 传输到适配器。

不得使 HwVidSynchronizeExecutionCallback 可分页。