客户端模块的 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 调用客户端模块的 < 回调函数。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
| 目标平台 | 窗户 |
| 标头 | netioddk.h (包括 Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |