NmrDeregisterClient 関数 (netioddk.h)

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

NmrDeregisterClient 関数は、NMR からクライアントモジュールを登録解除します。

構文

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

パラメーター

[in] NmrClientHandle

クライアントモジュールの登録を表すために NMR によって使用されるハンドル。クライアントモジュールが NmrRegisterClient 関数を呼び出すと、NMR はクライアントモジュールにこのハンドルを返します。

戻り値

NmrDeregisterClient 関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_PENDING	NMR によってクライアントモジュールの登録解除が開始されました。クライアントモジュールは、を呼び出す必要があります。クライアントモジュールをアンロードする前に、登録解除が完了するまで待機する NmrWaitForClientDeregisterComplete 関数。
その他の状態コード	エラーが発生しました。

解説

クライアントモジュールが NmrDeregisterClient 関数を呼び出すと、NMR はクライアントモジュールの ClientDetachProvider コールバック関数と、クライアントモジュールとプロバイダーモジュール間の各バインディングに対してプロバイダーモジュールの ProviderDetachClient コールバック関数を呼び出します。 NMR からのクライアントモジュールの登録解除は、クライアントモジュールが接続されているすべてのプロバイダーモジュールから正常にデタッチされ、それらのプロバイダーモジュールがすべてクライアントモジュールから正常にデタッチされた後に完了します。

クライアントモジュールは通常、Unload 関数から NmrDeregisterClient 関数を呼び出して、クライアントモジュールがシステムからアンロードされる前にアタッチされているすべてのプロバイダーモジュールから自身をデタッチします。 NmrDeregisterClient 関数を呼び出した後、クライアントモジュールはを呼び出す必要があります。クライアントモジュールをアンロードする前に、登録解除が完了するまで待つ NmrWaitForClientDeregisterComplete 関数。登録解除が完了するまで、クライアントモジュールは Unload 関数の呼び出しからを返してはなりません。

メモクライアントモジュールが Windows Driver Framework を使用する場合、通常は EvtDriverUnload イベントコールバック関数から NmrDeregisterClient 関数を呼び出します。このような状況では、登録解除が完了するまで、クライアントモジュールは EvtDriverUnload 関数の呼び出しからを返してはなりません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
対象プラットフォーム	デスクトップ
Header	netioddk.h (Wsk.h を含む)
Library	Netio.lib
IRQL	<= DISPATCH_LEVEL