IWDFDeviceInitialize::RetrieveDevicePropertyStore-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die RetrieveDevicePropertyStore Methode ruft einen Geräteeigenschaftenspeicher ab, über den Clients Geräteeigenschaften lesen und schreiben 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--terminated-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-typed-Wert, der angibt, wie der Geräteeigenschaftenspeicher abgerufen wird.
[out] ppPropStore
Ein Zeiger auf einen Puffer, der einen Zeiger auf die IWDFNamedPropertyStore Schnittstelle empfängt, die zum Abrufen von Geräteeigenschaften verwendet wird.
[out, optional] pDisposition
Ein Zeiger auf eine Variable, die einen WDF_PROPERTY_STORE_DISPOSITION-typed-Wert empfängt, der angibt, ob das Framework den Geräteeigenschaftenspeicher erstellt hat oder der Geräteeigenschaftenspeicher bereits vorhanden ist. Dieser Parameter ist optional. Der Treiber kann NULL- übergeben, wenn der Treiber keine Löschungsinformationen 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.
Bemerkungen
Der Aufrufer sollte die Release-Methode der IWDFNamedPropertyStore Schnittstelle nach Abschluss des Eigenschaftenspeichers aufrufen.
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 |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |