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

Siehe auch

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey-

DRIVER_REGKEY_TYPE