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)

另請參閱

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback