VideoPortInitialize 関数 (video.h)

VideoPortInitialize 関数は、ミニポート ドライバーの初期化の一部を実行し、ミニポート ドライバーのシステム リソースを割り当てる。

構文

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

パラメーター

Argument1

オペレーティング システムが Video ミニポート ドライバーの DriverEntry と呼ばれるポインター。

Argument2

オペレーティング システムが DriverEntry と呼ばれる 2 番目のポインター。

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 構造体を 0 で初期化します。
• VIDEO_PORT_CONFIG_INFOで可能な限り多くのアダプター構成情報を入力します。
• グラフィックス アダプターを表すためにシステムによって作成されたデバイス オブジェクトのパブリック メンバーの一部を入力します。 ビデオ ポート ドライバーは、デバイス オブジェクトを管理するため、ミニポート ドライバーは、デバイス オブジェクトの詳細に関係する必要はありません。
• のメモリを割り当て、デバイス オブジェクトのデバイス拡張機能を 0 から初期化します。 デバイス拡張機能は、各ミニポート ドライバーのプライマリであり、アダプター固有の状態情報のグローバル記憶域のみです。 ミニポート ドライバーは、VIDEO_HW_INITIALIZATION_DATAの HwDeviceExtensionSize メンバー内のデバイス拡張機能のサイズを指定します。 ビデオ ポート ドライバーは、呼び出すミニポート ドライバー関数のほとんどにこのデバイス拡張機能を渡します。
• 関連する情報を収集し、デバイス拡張機能に格納します。

要件

こちらもご覧ください

ビデオ ミニポート ドライバーの DriverEntry

HwVidFindAdapter

HwVidInitialize

VIDEO_HW_INITIALIZATION_DATA

VIDEO_PORT_CONFIG_INFO

VideoPortZeroMemory