WdfDriverOpenPersistentStateRegistryKey-Funktion (wdfdriver.h)
Treiber sollten WdfDriverOpenPersistentStateRegistryKey verwenden, um treiberweite persistente Informationen in die Registrierung zu schreiben.
Syntax
NTSTATUS WdfDriverOpenPersistentStateRegistryKey(
[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 typisierten Wert, der eine Zugriffsmaske für den Registrierungsschlüssel angibt. Ein KMDF-Treiber fordert in der Regel KEY_READ, KEY_WRITE oder KEY_READ | KEY_WRITE an. 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
Weitere Informationen finden Sie unter WdfDriverOpenParametersRegistryKey.
Hinweise
Der Parameters Schlüssel gilt für unveränderliche Einstellungen, die in der INF-Datei bereitgestellt werden. Verwenden Sie WdfDriverOpenParametersRegistryKey, um auf diese Einstellungen zuzugreifen. Der von dieser API zurückgegebene Schlüssel gilt für Einstellungen, die zur Laufzeit geschrieben wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| KMDF-Mindestversion | 1,25 |
| UMDF-Mindestversion | 2.25 |
| Kopfzeile | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |