VideoPortInitialize 函数 (video.h)

项目
02/29/2024

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 只有在先进行零初始化，然后设置VIDEO_HW_INITIALIZATION_DATA结构后，才能调用 VideoPortInitialize。 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 (包括 Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL