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) |