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
);
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 typisierter Wert, der ein Zugriffsformat für den Registrierungsschlüssel angibt. Ein KMDF-Treiber fordert in der Regel KEY_READ, KEY_WRITEoder KEY_READ | KEY_WRITEan. 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
Weitere Informationen finden Sie unter WdfDriverOpenParametersRegistryKey.
Bemerkungen
Der Parameters Schlüssel ist für unveränderlichen Einstellungen in der INF-Datei vorgesehen. Verwenden Sie WdfDriverOpenParametersRegistryKey, um auf diese Einstellungen zuzugreifen. Der von dieser API zurückgegebene Schlüssel richtet sich an Einstellungen, die zur Laufzeit geschrieben wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützter Client (Mindestversion) | Windows 10, Version 1803 |
| Minimale KMDF-Version | 1.25 |
| Mindest-UMDF-Version | 2,25 |
| Kopfzeile | wdfdriver.h |
| IRQL | PASSIVE_LEVEL |