RxUnregisterMinirdr 関数 (rxstruc.h)

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

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

構文

void RxUnregisterMinirdr(
  [in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject
);

パラメーター

[in] RxDeviceObject

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

戻り値

なし

解説

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

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

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