NPI_CLIENT_DETACH_PROVIDER_FN コールバック関数 (netioddk.h)

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

クライアントモジュールの ClientDetachProvider コールバック関数は、プロバイダーモジュールからクライアントモジュールをデタッチします。

構文

NPI_CLIENT_DETACH_PROVIDER_FN NpiClientDetachProviderFn;

NTSTATUS NpiClientDetachProviderFn(
  [in] PVOID ClientBindingContext
)
{...}

パラメーター

[in] ClientBindingContext

クライアントモジュールとデタッチ元のプロバイダーモジュールとの間のバインドに対するクライアントモジュールのコンテキストへのポインター。クライアントモジュールは、 NmrClientAttachProvider 関数を呼び出してプロバイダーモジュールにアタッチするときに、このポインターを NMR に渡します。

戻り値

クライアントモジュールの ClientDetachProvider コールバック関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	クライアントモジュールがプロバイダーモジュールから正常にデタッチされました。
STATUS_PENDING	クライアントモジュールをプロバイダーモジュールからすぐにデタッチできませんでした。

注釈

クライアントモジュールとプロバイダーモジュール間のバインドを終了する必要がある場合は常に、クライアントモジュールの ClientDetachProvider コールバック関数が呼び出されます。デタッチは、 NmrDeregisterClient 関数を呼び出すクライアントモジュールまたは NmrDeregisterProvider 関数を呼び出すプロバイダーモジュールによって開始されます。

ClientDetachProvider コールバック関数が呼び出された後、クライアントモジュールはプロバイダーモジュールの NPI 関数をこれ以上呼び出さないでください。クライアントモジュールの ClientDetachProvider コールバック関数が呼び出されたときに、プロバイダーモジュールの NPI 関数への進行中の呼び出しがない場合、クライアントモジュールの ClientDetachProvider コールバック関数はSTATUS_SUCCESSを返します。

クライアントモジュールの ClientDetachProvider コールバック関数が呼び出されたときに、プロバイダーモジュールの NPI 関数の 1 つ以上の呼び出しが進行中の場合、クライアントモジュールの ClientDetachProvider コールバック関数はSTATUS_PENDINGを返します。この状況では、クライアントモジュールはを呼び出す必要があります。プロバイダーモジュールの NPI 関数に対するすべての進行中の呼び出しが完了した後の NmrClientDetachProviderComplete 関数。への呼び出し NmrClientDetachProviderComplete 関数は、プロバイダーモジュールからのデタッチが完了したことを NMR に通知します。

NMR は、クライアントモジュールのを呼び出します。 ClientCleanupBindingContext コールバック関数とプロバイダーモジュールのクライアントモジュールとプロバイダーモジュールの両方が相互にデタッチを完了した後の ProviderCleanupBindingContext コールバック関数。

NMR は、任意の IRQL <= DISPATCH_LEVELでクライアントモジュールの ClientDetachProvider コールバック関数を呼び出します。

要件

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