CmUnRegisterCallback 函式 (wdm.h)
CmUnRegisterCallback 例程會取消註冊先前註冊 CmRegisterCallback 或 CmRegisterCallbackEx 例程的 RegistryCallback 例程。
語法
NTSTATUS CmUnRegisterCallback(
[in] LARGE_INTEGER Cookie
);
參數
[in] Cookie
識別要取消註冊之回呼例程的LARGE_INTEGER值。 當您註冊回呼例程時,CmRegisterCallback 會提供此值。
傳回值
如果 CmUnRegisterCallback 成功,則會傳回STATUS_SUCCESS,如果失敗,則會傳回適當的 NTSTATUS 錯誤碼。 如果 Cookie 參數不符合任何已註冊的回呼例程, CmUnRegisterCallback 會傳回STATUS_INVALID_PARAMETER。
備註
呼叫 CmRegisterCallback 或 CmRegisterCallbackEx 的驅動程式應該在卸除驅動程式之前呼叫 CmUnRegisterCallback 。
驅動程式不得從其 RegistryCallback 例程的實作呼叫 CmUnRegisterCallback。 該呼叫會導致死結。
如需 CmUnRegisterCallback 和篩選登錄作業的詳細資訊,請參閱 篩選登錄呼叫。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 IrqlExApcLte2 (wdm) |