PVIDEO_HW_START_IO回调函数 (video.h)

HwVidStartIO 处理指定的 VRP。

语法

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

HwDeviceExtension

指向微型端口驱动程序的每个适配器存储区域的指针。有关详细信息，请参阅设备扩展。

RequestPacket

指向 VIDEO_REQUEST_PACKET 结构的指针，该结构包含最初传递给 EngDeviceIoControl 的所有参数。

HwVidStartIO 必须返回 TRUE，表示它已完成请求。

每个视频微型端口驱动程序都必须具有 HwVidStartIO 函数。

视频端口驱动程序调用 HwVidStartIO 以响应源自相应显示驱动程序的每个 GDI EngDeviceIoControl 请求。调用 HwVidStartIO 时，微型端口驱动程序将拥有输入视频请求数据包，直到完成请求的操作。 HwVidStartIO 必须执行以下操作：

查看 VRP 的 IoControlCode 成员，以确定显示驱动程序请求的操作。
检查 VRP InputBufferLength 和/或 OutputBufferLength 是否指示缓冲区的大小足以满足请求。如果任一缓冲区太小，微型端口驱动程序应返回错误。
满足请求。
在 VRP 中设置“状态”和“信息”成员并返回 TRUE。

系统视频端口驱动程序序列化所有请求。微型端口驱动程序无需执行自己的任何序列化，除非它具有 HwVidInterrupt 函数。

但是，每个微型端口驱动程序的 HwVidStartIO 函数必须完成每个请求的操作或在 VRP 的 StatusBlock 中设置适当的错误，然后才能返回控件。

应使 HwVidStartIO 可分页。

要求	值
目标平台	桌面
标头	video.h (包括 Video.h)