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. 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 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-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 , die zum Abrufen von Geräteeigenschaften verwendet wird.
[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 |