WdfDriverOpenParametersRegistryKey-Funktion (wdfdriver.h)

Artikel
08/08/2023

[Gilt für KMDF und UMDF]

Die WdfDriverOpenParametersRegistryKey-Methode öffnet den Registrierungsschlüssel Parameters des Treibers und ruft ein Handle für ein Framework-Registrierungsschlüsselobjekt ab, das den Schlüssel darstellt.

Syntax

NTSTATUS WdfDriverOpenParametersRegistryKey(
  [in]           WDFDRIVER              Driver,
  [in]           ACCESS_MASK            DesiredAccess,
  [in, optional] PWDF_OBJECT_ATTRIBUTES KeyAttributes,
  [out]          WDFKEY                 *Key
);

Parameter

[in] Driver

Ein Handle für das Frameworktreiberobjekt des Treibers, das der Treiber von einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriver abgerufen hat.

[in] DesiredAccess

Ein ACCESS_MASK typisierter Wert, der eine Zugriffsmaske für den Registrierungsschlüssel Parameters angibt.

Ein KMDF-Treiber fordert in der Regel KEY_READ, KEY_WRITE oder KEY_READ | KEY_WRITE.

Wenn Sie einen UMDF-Treiber schreiben, verwenden Sie KEY_READ oder KEY_READ | KEY_SET_VALUE.

Fragen Sie als bewährte Methode nur nach den Zugriffstypen, die Ihr Treiber benötigt.

[in, optional] KeyAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur , die Objektattribute für das Framework-Registrierungsschlüsselobjekt angibt. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] Key

Ein Zeiger auf einen Speicherort, der ein Handle für ein Framework-Registrierungsschlüsselobjekt empfängt.

Rückgabewert

WdfDriverOpenParametersRegistryKey gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_ACCESS_DENIED	Ein UMDF-Treiber hat eines der folgenden Flags im DesiredAccess-Parameter angegeben: GENERIC_WRITE KEY_CREATE_SUBKEY WRITE_DAC Da die obigen Werte für UMDF-Treiber ungültig sind, führen universelle Flags wie GENERIC_ALL und STANDARD_RIGHTS_ALL auch dazu, dass WdfDriverOpenParametersRegistryKey mit diesem Rückgabewert fehlschlägt.

Rückgabecode

Beschreibung

STATUS_ACCESS_DENIED

Ein UMDF-Treiber hat eines der folgenden Flags im DesiredAccess-Parameter angegeben:

GENERIC_WRITE
KEY_CREATE_SUBKEY
WRITE_DAC

Da die obigen Werte für UMDF-Treiber ungültig sind, führen universelle Flags wie GENERIC_ALL und STANDARD_RIGHTS_ALL auch dazu, dass WdfDriverOpenParametersRegistryKey mit diesem Rückgabewert fehlschlägt.

Weitere Informationen zu Rückgabewerten finden Sie unter Fehler beim Erstellen von Frameworkobjekten.

Diese Methode kann auch andere NTSTATUS-Werte zurückgeben.

Eine Systemfehlerprüfung tritt auf, wenn ein KMDF-Treiber ein ungültiges Handle im Treiber angibt.

Hinweise

Der Parameterschlüssel des Treibers befindet sich in der Services-Struktur der Registrierung. Wenn der Parameterschlüssel des Treibers nicht vorhanden ist, wird er von der WdfDriverOpenParametersRegistryKey-Methode erstellt.

Wenn der Treiber den Registrierungsschlüssel Parameters verwendet hat, muss der Treiber WdfRegistryClose aufrufen.

Hinweis

UMDF unterstützt das Erstellen von Unterschlüsseln nicht.

Weitere Informationen zur Registrierung finden Sie unter Verwenden der Registrierung in Framework-Based Treibern.

Beispiele

Im folgenden Codebeispiel wird der Registrierungsschlüssel Parameters eines Treibers geöffnet und ein Handle für ein Framework-Registrierungsschlüsselobjekt abgerufen, das den Schlüssel darstellt.

WDFKEY hKey;

status = WdfDriverOpenParametersRegistryKey(
                                            Driver,
                                            STANDARD_RIGHTS_ALL,
                                            WDF_NO_OBJECT_ATTRIBUTES,
                                            &hKey
                                            );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdriver.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)