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

  • [アーティクル]

プロバイダー モジュールの ProviderCleanupBindingContext コールバック関数は、プロバイダー モジュールとクライアント モジュールが互いにデタッチされた後に、プロバイダー モジュールのバインド コンテキストの必要なクリーンアップと割り当て解除を実行します。

構文

NPI_PROVIDER_CLEANUP_BINDING_CONTEXT_FN NpiProviderCleanupBindingContextFn;

void NpiProviderCleanupBindingContextFn(
  [in] PVOID ProviderBindingContext
)
{...}

パラメーター

[in] ProviderBindingContext

プロバイダー モジュールと、デタッチ元のクライアント モジュールとの間のバインディングに対するプロバイダー モジュールのコンテキストへのポインター。 プロバイダー モジュールの ProviderAttachClient コールバック関数は、クライアント モジュールにアタッチすると、このポインターを NMR に返します。

戻り値

なし

解説

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

プロバイダー モジュールの ProviderCleanupBindingContext コールバック関数は、プロバイダー モジュールのバインド コンテキスト構造に含まれるデータの必要なクリーンアップを実行する必要があります。 プロバイダー モジュールが構造体のメモリを動的に割り当てた場合は、バインド コンテキスト構造体のメモリを解放する必要があります。

プロバイダー モジュールがバインド コンテキストにメモリを動的に割り当てず、そのバインド コンテキストの他のクリーンアップが必要ない場合、プロバイダー モジュールは ProviderCleanupBindingContext コールバック関数を実装する必要はありません。 プロバイダー モジュールが ProviderCleanupBindingContext コールバック関数を実装していない場合は、 の ProviderCleanupBindingContext メンバーを設定する 必要があります。 構造体をNULL にNPI_PROVIDER_CHARACTERISTICS、 NmrRegisterProvider 関数を呼び出して自身を NMR に登録します。

NMR は、IRQL <= DISPATCH_LEVELでプロバイダー モジュールの ProviderCleanupBindingContext コールバック関数を呼び出します。

要件

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

こちらもご覧ください

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient