共用方式為

CmRegisterCallback 函式 (wdm.h)

  • 發行項

CmRegisterCallback 例程已過時，適用於 Windows Vista 和更新版本的操作系統版本。 請改用 CmRegisterCallbackEx 。

CmRegisterCallback 例程會註冊 RegistryCallback 例程。

語法

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

參數

[in] Function

要註冊之 RegistryCallback 例程的指標。

[in, optional] Context

組態管理員將作為 CallbackContext 參數傳遞至 RegistryCallback 例程的驅動程式定義值

[out] Cookie

LARGE_INTEGER變數的指標，可接收識別回呼例程的值。 當您取消註冊回呼例程時，請將此值當做 Cookie 參數傳遞至 CmUnRegisterCallback。

傳回值

如果作業成功，CmRegisterCallback 會傳回STATUS_SUCCESS，如果作業失敗，則傳回適當的 NTSTATUS 錯誤碼。

備註

CmRegisterCallback 例程適用於 Windows XP 和更新版本的作業系統版本。 針對 Windows Vista 和更新版本的作業系統版本，您應該改用 CmRegisterCallbackEx 。

驅動程式會呼叫 CmRegisterCallback 來註冊 RegistryCallback 例程，每次線程在登錄上執行作業時都會呼叫此例程。

呼叫 CmUnRegisterCallback 以取消註冊 CmRegisterCallback 註冊的回呼例程。

如需 CmRegisterCallback 和篩選登錄作業的詳細資訊，請參閱 篩選登錄呼叫。

規格需求

需求 值
最低支援的用戶端 可在 Windows XP 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <=APC_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 IrqlExApcLte2 (wdm)

另請參閱

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback