StreamClassRegisterAdapter 関数 (strmini.h)

[アーティクル]
02/29/2024

StreamClassRegisterAdapter ルーチンは、ストリームクラスミニドライバーを登録します。

StreamClassRegisterAdapter という名前は、下位互換性のためにのみサポートされています。

代わりに、StreamClassRegisterAdapter のエイリアスである StreamClassRegisterMinidriver を使用することをお勧めします。 StreamClassRegisterMinidriver という名前は、ルーチンがストリームクラスミニドライバーを登録することをより正確に示します。登録すると、ミニドライバーはシステム内の任意の数のアダプターインスタンスを駆動できます。

StreamClassRegisterMinidriver ルーチンは、ストリームクラスドライバーにストリームミニドライバーを登録します。

構文

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

パラメーター

[in] Argument1

ミニドライバーの DriverEntry ルーチンの最初の引数をポイントします。

[in] Argument2

ミニドライバーの DriverEntry ルーチンの 2 番目の引数をポイントします。

[in] HwInitializationData

ミニドライバーの初期化を開始するためにクラスドライバーが必要とする情報を提供するHW_INITIALIZATION_DATA構造体を指します。

戻り値

成功した場合はSTATUS_SUCCESS、失敗した場合は適切なエラーコードを返します。

注釈

ストリームミニドライバーは、その DriverEntry ルーチン内で StreamClassRegisterMinidriver を呼び出す必要があります。

ストリームミニドライバーの DriverEntry は、ストリームクラスミニドライバーを初期化します。このルーチンは必須です。

Argument1 アダプターミニドライバーが StreamClassRegisterMinidriver を呼び出すコンテキスト値を指定します。 Windows 2000 以降の場合、これはDRIVER_OBJECTを指します。

Argument2 アダプターミニドライバーが StreamClassRegisterMinidriver を呼び出す必要がある 2 番目のコンテキスト値を指定します。 Windows 2000 以降の場合、これはレジストリパスを指します。

DriverEntry は、 StreamClassRegisterMinidriver の呼び出しによって返される値を返します。

解説 DriverEntry は、ストリームクラスミニドライバーの最初のエントリポイントです。

StreamClassRegisterMinidriver は必要なドライバーの初期化のほとんどを実行するため、ストリームクラスミニドライバーの DriverEntry ルーチンの主なタスクは、ドライバー固有の定数とエントリポイントを使用してHW_INITIALIZATION_DATA構造体を割り当てて入力することです。 DriverEntry は、 StreamClassRegisterMinidriver を呼び出す必要があります。

HW_INITIALIZATION_DATA構造体で渡される情報のほとんどは、ミニドライバー全体のコールバックと、ミニドライバーのデータ構造に割り当てるサイズバッファーをクラスドライバーに通知します。クラスドライバーは、ミニドライバーの StrMiniReceiveDevicePacket ルーチン (HW_INITIALIZATION_DATA の HwReceivePacket メンバーとして渡されます) に対するSRB_INITIALIZE_DEVICEとSRB_GET_STREAM_INFO要求を通じて、追加のスタートアップ情報をミニドライバーに照会します。

登録すると、ミニドライバーはシステム内の任意の数のアダプターインスタンスを駆動できます。