nmrWaitForClientDeregisterComplete 函数 (netioddk.h)

  • 项目

NmrWaitForClientDeregisterComplete 函数等待客户端模块的取消注册完成。

语法

NTSTATUS NmrWaitForClientDeregisterComplete(
  [in] HANDLE NmrClientHandle
);

参数

[in] NmrClientHandle

NMR 用于表示客户端模块注册的句柄。 当客户端模块调用 NmrRegisterClient 函数时，NMR 将此句柄返回到客户端模块。

返回值

NmrWaitForClientDeregisterComplete 函数返回以下 NTSTATUS 代码之一：

返回代码 说明
STATUS_SUCCESS
 NMR 已完成取消注册客户端模块。
STATUS_INVALID_PARAMETER
 客户端模块在调用 NmrDeregisterClient 函数之前调用 NmrWaitForClientDeregisterComplete 函数，或者 NmrClientHandle 参数中指定的句柄不是有效的客户端句柄。
其他状态代码
 出现了错误。

注解

客户端模块调用 NmrWaitForClientDeregisterComplete 函数以等待客户端模块的取消注册完成。 客户端模块仅在调用 NmrDeregisterClient 函数后调用 NmrWaitForClientDeregisterComplete 函数。

客户端模块通常从其 Unload 函数调用 NmrWaitForClientDeregisterComplete 函数，等待它从 NMR 中完全取消注册，然后再从系统卸载客户端模块。 在注销完成之前，客户端模块不得从对其 Unload 函数的调用返回。

注意如果客户端模块使用 Windows 驱动程序框架，它通常会从其 EvtDriverUnload 事件回调函数调用 NmrWaitForClientDeregisterComplete 函数。 在这种情况下，在取消注册完成之前，客户端模块不得从对其 EvtDriverUnload 函数的调用返回。
 

要求

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

另请参阅

NmrDeregisterClient