nmrWaitForClientDeregisterComplete 函式 (netioddk.h)
NmrWaitForClientDeregisterComplete 函式會等候用戶端模組的取消註冊完成。
語法
NTSTATUS NmrWaitForClientDeregisterComplete(
[in] HANDLE NmrClientHandle
);
參數
[in] NmrClientHandle
NMR 用來表示用戶端模組註冊的句柄。 當用戶端模組呼叫 NmrRegisterClient 函式時,NMR 會將此句柄傳回給客戶端模組。
傳回值
NmrWaitForClientDeregisterComplete 函式會傳回下列其中一個 NTSTATUS 代碼:
傳回碼 | Description |
---|---|
|
NMR 已完成取消註冊客戶端模組。 |
|
在呼叫 NmrDeregisterClient 函式之前,用戶端模組稱為 NmrWaitForClientDeregisterComplete 函式,或 NmrClientHandle 參數中指定的句柄不是有效的用戶端句柄。 |
|
發生錯誤。 |
備註
用戶端模組會呼叫 NmrWaitForClientDeregisterComplete 函式,以等候客戶端模組的取消註冊完成。 用戶端模組只會在呼叫NmrDeregisterClient函式之後呼叫NmrWaitForClientDeregisterComplete函式。
用戶端模組通常會從其 Unload 函式呼叫 NmrWaitForClientDeregisterComplete 函式,等到從 NMR 完全取消註冊,再從系統卸除用戶端模組。 在取消註冊完成之前,用戶端模組不得從呼叫其 Unload 函式傳回。
注意如果用戶端模組使用 Windows Driver Framework,它通常會從其 EvtDriverUnload 事件回呼函式呼叫 NmrWaitForClientDeregisterComplete 函式。 在此情況下,用戶端模組不得從其 EvtDriverUnload 函式的呼叫傳回,直到取消註冊完成為止。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | 桌面 |
標頭 | netioddk.h (包含 Wsk.h) |
程式庫 | Netio.lib |
IRQL | < DISPATCH_LEVEL |