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

Weitere Informationen

WdfDriverOpenParametersRegistryKey

IoOpenDriverRegistryKey

DRIVER_REGKEY_TYPE