CmRegisterCallback-Funktion (wdm.h)

  • Artikel

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)

Weitere Informationen

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback