VideoPortInitialize 函数（video.h）

项目
02/07/2025

VideoPortInitialize 函数执行微型端口驱动程序初始化的一部分，为微型端口驱动程序分配系统资源。

语法

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

参数

Argument1

作系统调用 Video Miniport Driver的 DriverEntry 的指针。

Argument2

作系统调用 DriverEntry的第二个指针。

HwInitializationData

指向堆栈上 VIDEO_HW_INITIALIZATION_DATA 结构的指针。微型端口驱动程序的 DriverEntry 例程零初始化此结构，然后使用特定于驱动程序的配置信息填充该结构，其中描述了微型端口驱动程序可以支持的视频适配器。

HwContext

必须为 NULL 。

返回值

VideoPortInitialize 返回初始化作的最终状态。

言论

每个视频微型端口驱动程序都必须从其 DriverEntry 函数调用 VideoPortInitialize。 DriverEntry 只有在首次初始化 videoPortInitialize 后才能调用 videoPortInitialize，然后设置 VIDEO_HW_INITIALIZATION_DATA 结构。 VideoPortInitialize 只能从微型端口驱动程序的 DriverEntry 函数调用。

VideoPortInitialize 函数：

检查微型端口驱动程序VIDEO_HW_INITIALIZATION_DATA规范的有效性。
为 VIDEO_PORT_CONFIG_INFO 结构分配内存并将其从零初始化。
在VIDEO_PORT_CONFIG_INFO中填写尽可能多的适配器配置信息。
填写系统创建的用于表示图形适配器的设备对象的一些公共成员。视频端口驱动程序管理设备对象，因此，微型端口驱动程序不需要关注设备对象详细信息。
分配设备对象的内存并零初始化设备扩展。 设备扩展 是每个微型端口驱动程序的主存储区域，也是特定于适配器的状态信息的全局存储区域。微型端口驱动程序指定 VIDEO_HW_INITIALIZATION_DATA HwDeviceExtensionSize 成员中的设备扩展大小。视频端口驱动程序将此设备扩展传递给它调用的大多数微型端口驱动程序函数。
在设备扩展中收集和存储相关信息。

微型端口驱动程序的 DriverEntry 例程将 VideoPortInitialize 返回的值 传播回其调用方。微型端口驱动程序不应使用此返回值。

要求

要求	价值
最低支持的客户端	在 Windows 2000 及更高版本的 Windows作系统中可用。
目标平台	桌面
标头	video.h （include Video.h）
库	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL