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_DATA の HwReceivePacket メンバーとして渡されます) への SRB_INITIALIZE_DEVICE および SRB_GET_STREAM_INFO 要求を通じて、ミニドライバーに追加のスタートアップ情報を照会します。
登録すると、ミニドライバーはシステム内の任意の数のアダプター インスタンスを駆動できます。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | strmini.h (Strmini.h を含む) |
関連項目
StrMiniReceiveDevicePacket の