NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN回调函数 (netioddk.h)

项目
08/07/2023

客户端模块的 ClientCleanupBindingContext 回调函数在客户端模块和提供程序模块彼此分离后，对客户端模块的绑定上下文执行任何必要的清理和解除分配。

语法

NPI_CLIENT_CLEANUP_BINDING_CONTEXT_FN NpiClientCleanupBindingContextFn;

void NpiClientCleanupBindingContextFn(
  [in] PVOID ClientBindingContext
)
{...}

参数

[in] ClientBindingContext

指向客户端模块上下文的指针，用于客户端模块与它已从中分离的提供程序模块之间的绑定。客户端模块在调用 NmrClientAttachProvider 函数以附加到提供程序模块时将此指针传递到 NMR。

返回值

无

备注

在客户端模块和提供程序模块彼此分离后，NMR 调用客户端模块的 ClientCleanupBindingContext 回调函数。

客户端模块的 ClientCleanupBindingContext 回调函数应对客户端模块的绑定上下文结构中包含的数据执行任何必要的清理。然后，如果客户端模块动态分配了该结构的内存，则它应释放绑定上下文结构的内存。

如果客户端模块未为其绑定上下文动态分配内存，并且不需要对其绑定上下文进行其他清理，则客户端模块不需要实现 ClientCleanupBindingContext 回调函数。如果客户端模块未实现 ClientCleanupBindingContext 回调函数，则必须设置 的 ClientCleanupBindingContext 成员调用 NmrRegisterClient 函数以向 NMR 注册自身时，将结构NPI_CLIENT_CHARACTERISTICS为 NULL。

NMR 在任意 IRQL <= DISPATCH_LEVEL调用客户端模块的 ClientCleanupBindingContext 回调函数。

要求

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