VideoPortInitialize 関数 (video.h)

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

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 ルーチンは、 VideoPortInitialize によって返される値を呼び出し元に伝達します。ミニポートドライバーでは、この戻り値を使用しないでください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	video.h (Video.h を含む)
Library	Videoprt.lib
[DLL]	Videoprt.sys
IRQL	PASSIVE_LEVEL