次の方法で共有


VideoPortInitialize 関数 (video.h)

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

構文

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

パラメーター

Argument1

ビデオ ミニポート ドライバーの 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 構造体のメモリを割り当て、ゼロ初期化します。
  • 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

関連項目

DriverEntry of Video ミニポート ドライバー

HwVidFindAdapter する

HwVidInitialize

VIDEO_HW_INITIALIZATION_DATA

VIDEO_PORT_CONFIG_INFO

VideoPortZeroMemory