videoPortInitialize 函式 (video.h)

發行項
02/26/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 只能在第一次初始化零之後呼叫 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 (包含 Video.h)
程式庫	Videoprt.lib
Dll	Videoprt.sys
IRQL	PASSIVE_LEVEL