CmRegisterCallback-Funktion (wdm.h)
Die CmRegisterCallback-Routine ist für Windows Vista und höhere Betriebssystemversionen veraltet . Verwenden Sie stattdessen CmRegisterCallbackEx .
Die CmRegisterCallback-Routine registriert eine RegistryCallback-Routine .
Syntax
NTSTATUS CmRegisterCallback(
[in] PEX_CALLBACK_FUNCTION Function,
[in, optional] PVOID Context,
[out] PLARGE_INTEGER Cookie
);
Parameter
[in] Function
Ein Zeiger auf die Registrierungsroutine "RegistryCallback ".
[in, optional] Context
Ein vom Treiber definierter Wert, den der Konfigurations-Manager als CallbackContext-Parameter an die RegistryCallback-Routine übergibt
[out] Cookie
Ein Zeiger auf eine LARGE_INTEGER Variable, die den Wert empfängt, der die Rückrufroutine identifiziert. Wenn Sie die Registrierung der Rückrufroutine aufheben, übergeben Sie diesen Wert als Cookie-Parameter an CmUnRegisterCallback.
Rückgabewert
CmRegisterCallback gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder den entsprechenden NTSTATUS-Fehlercode , wenn er fehlschlägt.
Hinweise
Die CmRegisterCallback-Routine ist unter Windows XP und höheren Betriebssystemversionen verfügbar. Für Windows Vista und höhere Betriebssystemversionen sollten Sie stattdessen CmRegisterCallbackEx verwenden.
Ein Treiber ruft CmRegisterCallback auf, um eine RegistryCallback-Routine zu registrieren, die jedes Mal aufgerufen wird, wenn ein Thread einen Vorgang für die Registrierung ausführt.
Rufen Sie CmUnRegisterCallback auf, um die Registrierung einer Rückrufroutine aufzuheben, die CmRegisterCallback registriert hat.
Weitere Informationen zu CmRegisterCallback und zum Filtern von Registrierungsvorgängen finden Sie unter Filtern von Registrierungsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows XP und höheren Versionen von Windows. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <=APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |