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) |