IWDFDevice::RetrieveDevicePropertyStore-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die RetrieveDevicePropertyStore-Methode ruft eine Eigenschaftenspeicherschnittstelle ab, die Treiber für den Zugriff auf die Registrierung verwenden können.

Syntax

HRESULT RetrieveDevicePropertyStore(
  [in, optional]  PCWSTR                            pcwszServiceName,
  [in]            WDF_PROPERTY_STORE_RETRIEVE_FLAGS Flags,
  [out]           IWDFNamedPropertyStore            **ppPropStore,
  [out, optional] WDF_PROPERTY_STORE_DISPOSITION    *pDisposition
);

Parameter

[in, optional] pcwszServiceName

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Geräteeigenschaftenspeichers darstellt. Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber keinen Namen für einen Geräteeigenschaftenspeicher angibt.

[in] Flags

Ein WDF_PROPERTY_STORE_RETRIEVE_FLAGS typisierter Wert, der angibt, wie der Geräteeigenschaftenspeicher abgerufen werden kann.

[out] ppPropStore

Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFNamedPropertyStore-Schnittstelle empfängt . Der Treiber verwendet diese Schnittstelle, um auf Werte in der Registrierung zuzugreifen.

[out, optional] pDisposition

Ein Zeiger auf eine Variable, die einen WDF_PROPERTY_STORE_DISPOSITION typisierten Wert empfängt, der angibt, ob das Framework den Geräteeigenschaftenspeicher oder den Geräteeigenschaftenspeicher bereits erstellt hat. Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Dispositionsinformationen nicht benötigt.

Rückgabewert

RetrieveDevicePropertyStore gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Der Aufrufer sollte die Release-Methode der IWDFNamedPropertyStore-Schnittstelle aufrufen, nachdem er den Eigenschaftenspeicher abgeschlossen hat.

Weitere Informationen finden Sie unter Verwenden der Registrierung in UMDF-basierten Treibern.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll