次の方法で共有


StreamClassRegisterAdapter 関数 (strmini.h)

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_DATAHwReceivePacket メンバーとして渡されます) に対するSRB_INITIALIZE_DEVICEとSRB_GET_STREAM_INFO要求を通じて、追加のスタートアップ情報をミニドライバーに照会します。

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

要件

要件
対象プラットフォーム デスクトップ
Header strmini.h (Strmini.h を含む)

こちらもご覧ください

HW_INITIALIZATION_DATA

SRB_GET_STREAM_INFO

SRB_INITIALIZE_DEVICE

StrMiniReceiveDevicePacket