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 メンバーを設定する必要があります。 NmrRegisterProvider 関数を呼び出して自身をNMRに登録するときに、NULL を する構造体を NPI_PROVIDER_CHARACTERISTICS します。
このNMR は、任意の IRQL <= DISPATCH_LEVELでプロバイダー モジュールの ProviderCleanupBindingContext コールバック関数を呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | netioddk.h (Wsk.h を含む) |
| IRQL | <= DISPATCH_LEVEL |