Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 RegistryCallback Routine, die registriert werden soll.
[in] Altitude
Ein Zeiger auf eine UNICODE_STRING Struktur. Diese Struktur muss eine Zeichenfolge enthalten, die die Höhe des aufrufenden Minifiltertreibersdarstellt. 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 Konfigurations-Manager definierter Wert, der als CallbackContext Parameter an die RegistryCallback Routine übergeben wird.
[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 |
|---|---|
|
Der aufrufende Treiber oder ein anderer Treiber hat bereits eine RegistryCallback- Routine für die angegebene Höhe registriert. |
|
Fehler beim Versuch, Arbeitsspeicher zuzuweisen. |
Bemerkungen
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 in der 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 Load Order Groups and Altitudes for Minifilter Drivers.
Rufen Sie CmUnRegisterCallback- auf, um die Registrierung einer Rückrufroutine aufzuheben, die CmRegisterCallbackEx registriert.
Weitere Informationen zu CmRegisterCallbackEx-- und Filterregistrierungsvorgängen finden Sie unter Filtern von Registrierungsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <=APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), IrqlExApcLte2(wdm) |