NmrDeregisterProvider 関数 (netioddk.h)

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

NmrDeregisterProvider 関数は、NMR からプロバイダーモジュールを登録解除します。

構文

NTSTATUS NmrDeregisterProvider(
  [in] HANDLE NmrProviderHandle
);

パラメーター

[in] NmrProviderHandle

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

戻り値

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

リターンコード	説明
STATUS_PENDING	NMR はプロバイダーモジュールの登録解除を開始しました。プロバイダーモジュールは、を呼び出す必要があります。 NmrWaitForProviderDeregisterComplete 関数は、登録解除が完了するまで待機してから、プロバイダーモジュールをアンロードできます。
その他の状態コード	エラーが発生しました。

解説

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

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

メモプロバイダーモジュールが Windows Driver Framework を使用する場合、通常は、 EvtDriverUnload イベントコールバック関数の NmrDeregisterProvider 関数。この状況では、登録解除が完了するまで、プロバイダーモジュールは EvtDriverUnload 関数の呼び出しからを返す必要があります。

要件

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