CmRegisterCallbackEx-Funktion (wdm.h)

Artikel
02/27/2024

Die CmRegisterCallbackEx-Routine registriert eine RegistryCallback-Routine .

Syntax

NTSTATUS CmRegisterCallbackEx(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in]           PCUNICODE_STRING      Altitude,
  [in]           PVOID                 Driver,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie,
                 PVOID                 Reserved
);

Parameter

[in] Function

Ein Zeiger auf die Zu registrierende RegistryCallback-Routine .

[in] Altitude

Ein Zeiger auf eine UNICODE_STRING-Struktur . Diese Struktur muss eine Zeichenfolge enthalten, die die Höhe des aufrufenden Minifiltertreibers darstellt. Weitere Informationen finden Sie in den Hinweisen.

[in] Driver

Ein Zeiger auf die DRIVER_OBJECT-Struktur , die den Treiber darstellt.

[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.

Reserved

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

CmRegisterCallbackEx gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	Der aufrufende Treiber oder ein anderer Treiber hat bereits eine RegistryCallback-Routine für die angegebene Höhe registriert.
STATUS_INSUFFICIENT_RESOURCES	Fehler beim Belegen von Speicher

Hinweise

Die CmRegisterCallbackEx-Routine ist ab Windows Vista verfügbar.

Ein Treiber kann CmRegisterCallback oder CmRegisterCallbackEx aufrufen, um eine RegistryCallback-Routine zu registrieren, die jedes Mal aufgerufen wird, wenn ein Thread einen Vorgang für die Registrierung ausführt.

Der Parameter Altitude definiert die Position des Minifiltertreibers relativ zu anderen Minifiltern im E/A-Stapel, wenn der Minifilter geladen wird. Die Zuordnung von Höhen zu Minifiltern wird von Microsoft verwaltet. Weitere Informationen zu Höhen finden Sie unter Ladereihenfolgegruppen und Höhen für Minifiltertreiber.

Rufen Sie CmUnRegisterCallback auf, um die Registrierung einer Rückrufroutine aufzuheben, die cmRegisterCallbackEx registriert hat.

Weitere Informationen zu CmRegisterCallbackEx und zum Filtern von Registrierungsvorgängen finden Sie unter Filtern von Registrierungsaufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows Vista.
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