NmrWaitForProviderDeregisterComplete 関数 (netioddk.h)

  • [アーティクル]

NmrWaitForProviderDeregisterComplete 関数は、プロバイダー モジュールの登録解除が完了するまで待機します。

構文

NTSTATUS NmrWaitForProviderDeregisterComplete(
  [in] HANDLE NmrProviderHandle
);

パラメーター

[in] NmrProviderHandle

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

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 NMR はプロバイダー モジュールの登録解除を完了しました。
STATUS_INVALID_PARAMETER
 NmrDeregisterProvider 関数を呼び出す前に NmrWaitForProviderDeregisterComplete 関数と呼ばれるプロバイダー モジュール、または NmrClientHandle パラメーターで指定されたハンドルが有効なプロバイダー ハンドルではありません。
その他の状態コード
 エラーが発生しました。

解説

プロバイダー モジュールは 、NmrWaitForProviderDeregisterComplete 関数を呼び出して、プロバイダー モジュールの登録解除が完了するまで待機します。 プロバイダー モジュールは、NmrDeregisterProvider 関数を呼び出した後にのみ、 NmrWaitForProviderDeregisterComplete 関数 を 呼び出します。

プロバイダー モジュールは通常、Unload 関数から NmrWaitForProviderDeregisterComplete 関数を呼び出して、プロバイダー モジュールがシステムからアンロードされる前に、NMR から完全に登録解除されるまで待機します。 登録解除が完了するまで、プロバイダー モジュールは Unload 関数の呼び出しからを返してはなりません。

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

要件

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

こちらもご覧ください

NmrDeregisterProvider