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.
[Gilt für KMDF und UMDF]
Die WdfDriverOpenParametersRegistryKey Methode öffnet die Parameters Registrierungsschlüssel 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
);
Die Parameter
[in] Driver
Ein Handle für das Framework-Treiberobjekt des Treibers, das der Treiber aus einem vorherigen Aufruf von WdfDriverCreate oder WdfGetDriverabgerufen hat.
[in] DesiredAccess
Ein ACCESS_MASK-typed-Wert, der ein Zugriffsformat für den Parameter Registrierungsschlüssel angibt.
Ein KMDF-Treiber fordert in der Regel KEY_READ, KEY_WRITEoder KEY_READ | KEY_WRITE.
Wenn Sie einen UMDF-Treiber schreiben, verwenden Sie KEY_READ oder KEY_READ | KEY_SET_VALUE.
Bitten Sie als bewährte Methode nur um die 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 zu einem 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 parameter DesiredAccess 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 fehlschlagen. |
Weitere Informationen zu Rückgabewerten finden Sie unter Framework Object Creation Errors.
Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.
Eine Systemfehlerüberprüfung tritt auf, wenn ein KMDF-Treiber ein ungültiges Handle in Driverangibt.
Bemerkungen
Der Parameter des Treibers Schlüssels befindet sich in der Services--Struktur der Registrierung. Wenn der Parameter des Treibers Schlüssel nicht vorhanden ist, erstellt die WdfDriverOpenParametersRegistryKey-Methode sie.
Wenn der Treiber die Verwendung des Parameters Registrierungsschlüssel abgeschlossen hat, muss der Treiber WdfRegistryCloseaufrufen.
Hinweis
UMDF unterstützt das Erstellen von Unterschlüsseln nicht.
Weitere Informationen zur Registrierung finden Sie unter Verwenden der Registrierung in Framework-Based Drivers.
Beispiele
Im folgenden Codebeispiel wird die Parameters eines Treibers Registrierungsschlüssels 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 |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfdriver.h (einschließen Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |