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 时，将结构NPI_PROVIDER_CHARACTERISTICS为 NULL。

NMR 在任意 IRQL <= DISPATCH_LEVEL调用提供程序模块的 ProviderCleanupBindingContext 回调函数。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 Windows
标头 netioddk.h (包括 Wsk.h)
IRQL <= DISPATCH_LEVEL

另请参阅

ClientDetachProvider

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient

ProviderDetachClient