VIDEO_HW_INITIALIZATION_DATA構造 (video.h)

[アーティクル]
08/08/2023

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 関数に渡される前に 0 で初期化します。

StartingDeviceNumber

0 に設定する必要があります。

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 関数へのポインター。これにより、ドライバーはデバイス ID とベンダー ID に基づいてレガシリソースを指定できます。

AllowEarlyEnumeration

アダプターが開始される前に、ミニポートドライバーが子デバイスを列挙できるようにします。つまり、ビデオポートドライバーは、このメンバーが TRUE に設定されている場合、HwVidFindAdapter の前に HwVidGetVideoChildDescriptor を呼び出すことができます。

Reserved

システムで使用するために予約されています。