VIDEO_HW_INITIALIZATION_DATA 結構 (video.h)

  • 發行項

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、 HwVidSynchronizeExecutionCallback 和任何 SvgaHwIoPortXxx 函式之外，每個對迷你埠驅動程式標準函式所做的呼叫都會傳遞裝置延伸模組的指標。 視訊埠驅動程式會配置裝置擴充功能的記憶體，並以零初始化，再將其傳遞至迷你埠驅動程式的 HwVidFindAdapter 函式。

StartingDeviceNumber

必須設定為零。

HwResetHw

迷你埠驅動程式 的 HwVidResetHw 函式指標，這是適配卡的任何迷你埠驅動程式在電腦軟重新啟動時完全重設的必要專案。 在收到 INT10、MODE3 類型命令時，完全重設為 VGA 標準字元模式的 SVGA 配接器驅動程式通常會將此設定為 NULL。

HwTimer

迷你埠驅動程式 HwVidTimer 函式的指標，這是選擇性的。 此指標可以是 NULL。

HwStartDma

保留供系統使用。

HwSetPowerState

迷你埠驅動程式 HwVidSetPowerState 函式的指標，這是所有迷你埠驅動程式的必要專案。

HwGetPowerState

迷你埠驅動程式 HwVidGetPowerState 函式的指標，這是所有迷你埠驅動程式的必要專案。

HwGetVideoChildDescriptor

迷你埠驅動程式 HwVidGetVideoChildDescriptor 函式的指標，這是所有迷你埠驅動程式的必要專案。

HwQueryInterface

迷你埠驅動程式 HwVidQueryInterface 函式的指標。 這可選擇性地實作在支援外部程式設計介面的迷你埠驅動程式中，以進行裝置間通訊，例如 I2C (或IC) 支援 MPEG 譯碼器。 否則，此成員應設定為 NULL。

HwChildDeviceExtensionSize

這是與顯示輸出裝置相關聯的裝置擴充功能位元組大小。 只有在迷你埠驅動程式需要與配接器面板組態分開管理監視組態數據時，迷你埠驅動程式才應該填入此成員。

HwLegacyResourceList

VIDEO_ACCESS_RANGE 結構的陣列指標。 每個結構都會針對未列在PCI組態空間中的視訊適配卡描述裝置I/O埠或記憶體範圍。

HwLegacyResourceCount

這是 HwLegacyResourceList 所指向陣列中的元素數目。

HwGetLegacyResources

迷你埠驅動程式 的 HwVidLegacyResources 函式指標，可讓驅動程式根據其裝置和廠商識別符來指定其舊版資源。

AllowEarlyEnumeration

允許迷你埠驅動程式在適配卡啟動之前列舉其子裝置;也就是說，當此成員設定為TRUE時，視訊埠驅動程式可以在 HwVidFindAdapter 之前呼叫 HwVidGetVidEoChildDescriptor。

Reserved

保留供系統使用。

備註

迷你埠驅動程式的 DriverEntry 函式必須先以零初始化這個結構，才能設定任何成員中的相關值。

當 HwGetLegacyResources 以 HwVidLegacyResources 實作的指標初始化 HwLegacyResources 時，視訊埠驅動程式將會忽略 HwLegacyResourceCount 和 HwLegacyResourceList 成員。

規格需求

需求 值
標頭 video.h (包含 Video.h)

另請參閱

EMULATOR_ACCESS_ENTRY

HwVidLegacyResources

VIDEO_ACCESS_RANGE

VIDEO_PORT_CONFIG_INFO

VideoPortZeroMemory