RxpUnregisterMinirdr 関数 (mrx.h)

[アーティクル]
03/05/2024

RxpUnregisterMinirdr は、RDBSS にドライバーを登録解除し、内部 RDBSS 登録テーブルから登録情報を削除するために、ネットワークミニリダイレクタードライバーによって呼び出されます。

構文

void RxpUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

パラメーター

[in] RxDeviceObject

このネットワークリダイレクターの RDBSS デバイスオブジェクトへのポインター。

戻り値

なし

解説

RxpUnregisterMinirdr ルーチンは、RDBSS を使用してドライバーの登録を解除し、内部 RDBSS 登録テーブルから登録情報を削除します。名前テーブルが初期化された場合、これらのテーブルはリリースのために最終処理されます。ネットワークミニリダイレクターに対する未処理の非同期要求はすべてスピンダウンされ、リダイレクターに関連付けられているワーカースレッドはすべてスピンダウンされます。 RxpUnregisterMinirdr は、 IoDeleteDevice を呼び出して、システムからデバイスオブジェクトを削除しようとします。

RxpUnregisterMinirdr ルーチンは、通常、ネットワークミニリダイレクターから行うか、オペレーティングシステムによるシャットダウン処理の一環として、または DriverEntry ルーチンでエラーが発生した結果として、ネットワークミニリダイレクターをアンロードするユーザーモードのアプリケーションまたはサービスからの FSCTL または IOCTL 要求の結果として呼び出されます。

RDBSS を使用してドライバーの登録を解除するには、インラインルーチン RxUnregisterMinirdr が推奨される方法であることに注意してください。 RxUnregisterMinirdr インラインルーチンは RxpUnregisterMinirdr を呼び出しますが、RDBSS デバイスオブジェクトへのオブジェクト参照をデクリメントして、このオブジェクトをシステムから解放できるようにします。