video.h) (PVIDEO_HW_INITIALIZE 回调函数

HwVidInitialize 在 HAL 放弃对视频硬件的控制给视频端口驱动程序后,执行适配器的首次初始化。

语法

PVIDEO_HW_INITIALIZE PvideoHwInitialize;

BOOLEAN PvideoHwInitialize(
  PVOID HwDeviceExtension
)
{...}

参数

HwDeviceExtension

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

返回值

如果初始化成功, 则 HwVidInitialize 返回 TRUE

注解

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

视频端口驱动程序调用 HwVidInitialize 以响应相应显示驱动程序的打开请求。 调用 HwVidInitialize 后,微型端口驱动程序就可以更改适配器的状态,这与微型端口驱动程序的 HwVidFindAdapter 函数不同,后者必须将适配器保留为 VGA 模式。 从 HwVidInitialize 返回时,适配器必须初始化为与微型端口驱动程序的 HwVidResetHw 函数设置的状态等效的状态。 自动检测使用此功能从微型端口驱动程序获取模式信息。

如果可能, HwVidInitialize 应避免对设备硬件进行编程。 当指示微型端口驱动程序切换显示模式时,微型端口驱动程序稍后将初始化设备。

应使 HwVidInitialize 可分页。

要求

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

另请参阅

DrvAssertMode

HwVidFindAdapter

HwVidResetHw