VIDEO_HW_INITIALIZATION_DATA 結構會指定迷你埠驅動程序的進入點和儲存需求。 此結構會在堆疊上建立,並由迷你埠驅動程式的 DriverEntry 函式初始化。
語法
typedef struct _VIDEO_HW_INITIALIZATION_DATA {
ULONG HwInitDataSize;
INTERFACE_TYPE AdapterInterfaceType;
PVIDEO_HW_FIND_ADAPTER HwFindAdapter;
PVIDEO_HW_INITIALIZE HwInitialize;
PVIDEO_HW_INTERRUPT HwInterrupt;
PVIDEO_HW_START_IO HwStartIO;
ULONG HwDeviceExtensionSize;
ULONG StartingDeviceNumber;
PVIDEO_HW_RESET_HW HwResetHw;
PVIDEO_HW_TIMER HwTimer;
PVIDEO_HW_START_DMA HwStartDma;
PVIDEO_HW_POWER_SET HwSetPowerState;
PVIDEO_HW_POWER_GET HwGetPowerState;
PVIDEO_HW_GET_CHILD_DESCRIPTOR HwGetVideoChildDescriptor;
PVIDEO_HW_QUERY_INTERFACE HwQueryInterface;
ULONG HwChildDeviceExtensionSize;
PVIDEO_ACCESS_RANGE HwLegacyResourceList;
ULONG HwLegacyResourceCount;
PVIDEO_HW_LEGACYRESOURCES HwGetLegacyResources;
BOOLEAN AllowEarlyEnumeration;
ULONG Reserved;
} VIDEO_HW_INITIALIZATION_DATA, *PVIDEO_HW_INITIALIZATION_DATA;
成員
HwInitDataSize
這是這個 結構以位元組為單位的大小。 實際上,這表示所使用的VIDEO_HW_INITIALIZATION_DATA版本。
AdapterInterfaceType
目前視訊埠會忽略 ,而且應該保持零初始化。
HwFindAdapter
迷你埠驅動程式 HwVidFindAdapter 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwInitialize
迷你埠驅動程式 HwVidInitialize 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwInterrupt
迷你埠驅動程式 HwVidInterrupt 函式的指標,只有在迷你埠驅動程式的配接器產生中斷時,才需要此函式。 否則,這個指標必須 NULL。
HwStartIO
迷你埠驅動程式 HwVidStartIO 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwDeviceExtensionSize
指定迷你埠驅動程式為其私人適配卡特定裝置擴充功能所需的記憶體位元組大小。 迷你埠驅動程式會使用此記憶體來保存驅動程式決定的每個適配卡資訊,例如適配卡緩存器的對應邏輯位址範圍,以及驅動程式維護其 I/O 作業的任何內容資訊。
除了 DriverEntry、HwVidSynchronizeExecutionCallbackCallback 和任何 SvgaHwIoPortXxx 函式以外,都會傳遞裝置延伸模組的指標。 視訊埠驅動程式會配置裝置延伸模組的記憶體,並在它傳遞至迷你埠驅動程式的 HwVidFindAdapter 函式之前,使用零將其初始化。
StartingDeviceNumber
必須設定為零。
HwResetHw
迷你埠驅動程式 HwVidResetHw 函式的指標,這是適配卡的任何迷你埠驅動程式在機器軟重新啟動時未完全重設的必要專案。 在收到 INT10 MODE3 類型命令時,已完全重設為 VGA 標準字元模式的 SVGA 適配卡驅動程式通常會將此設定為 NULL。
HwTimer
迷你埠驅動程式 HwVidTimer 函式的指標,這是選擇性的。 這個指標可以 NULL。
HwStartDma
保留供系統使用。
HwSetPowerState
迷你埠驅動程式 HwVidSetPowerState 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwGetPowerState
迷你埠驅動程式 HwVidGetPowerState 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwGetVideoChildDescriptor
迷你埠驅動程式 HwVidGetVideoChildDescriptor 函式的指標,這是所有迷你埠驅動程式的必要專案。
HwQueryInterface
迷你埠驅動程式 HwVidQueryInterface 函式的指標。 這可以在支援外部程式設計介面的迷你埠驅動程式中選擇性地實作,以進行裝置間通訊,例如 MPEG 譯碼器 I2C(或 IーC) 支援。 否則,這個成員應該設定為 NULL。
HwChildDeviceExtensionSize
這是與顯示輸出裝置相關聯的裝置擴充功能位元組大小。 只有在迷你埠驅動程式需要與配接器面板設定分開管理監視設定數據時,迷你埠驅動程式才應該填入此成員。
HwLegacyResourceList
VIDEO_ACCESS_RANGE 結構的陣列指標。 每個結構描述未列在PCI組態空間中的視訊適配卡的裝置I/O埠或記憶體範圍。
HwLegacyResourceCount
這是陣列中 HwLegacyResourceList 點的項目數目。
HwGetLegacyResources
迷你埠驅動程式 HwVidLegacyResources 函式的指標,可讓驅動程式根據其裝置和廠商標識符來指定其舊版資源。
AllowEarlyEnumeration
允許迷你埠驅動程式在配接器啟動之前列舉其子裝置;也就是說,當此成員設定為 TRUE 之前,視訊埠驅動程式可以呼叫 HwVidGetVidEoChildDescriptorHwVidFindAdapter 。
Reserved
保留供系統使用。
言論
迷你埠驅動程式的 DriverEntry 函式必須先以零初始化此結構,才能在任何成員中設定相關值。
當 HwGetLegacyResource s 實作時,視訊埠驅動程式會忽略 HwLegacyResourceCount 和 HwLegacyResourceList 成員。
要求
| 要求 | 價值 |
|---|---|
| 標頭 | video.h (include Video.h) |