WdfDriverOpenParametersRegistryKey-Funktion (wdfdriver.h)
[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 |
|---|---|
|
Ein UMDF-Treiber hat eines der folgenden Flags im DesiredAccess-Parameter angegeben:
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) |