Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Von Bedeutung
Verwenden Sie stattdessen die UWP-Sensor-API .
Die COM-basierte Sensor-API ist veraltet und sollte nicht in neuen Anwendungen verwendet werden. Es sind keine zusätzlichen Features oder Verbesserungen geplant, und der Support wird eingeschränkt.
Ruft mehrere Sensoreigenschaften ab.
Syntax
HRESULT GetProperties(
[in] IPortableDeviceKeyCollection *pKeys,
[out] IPortableDeviceValues **ppProperties
);
Die Parameter
[in] pKeys
Zeiger auf eine IPortableDeviceKeyCollection-Schnittstelle , die die PROPERTYKEY-Auflistung für die angeforderten Eigenschaftswerte enthält. Legen Sie auf NULL fest, um alle unterstützten Eigenschaften abzurufen.
[out] ppProperties
Adresse eines IPortableDeviceValues-Zeigers , der den Zeiger auf die angeforderten Eigenschaftswerte empfängt.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.
| Rückgabecode | Description |
|---|---|
|
Die Methode war erfolgreich. |
|
Der Sensortreiber unterstützt nicht mindestens eine der angegebenen Eigenschaften. Jede nicht unterstützte Eigenschaft PROPVARIANT , die über die IPortableDeviceValues-Schnittstelle zurückgegeben wird, hat ihren Fehlerwert auf HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) festgelegt. |
|
NULL wurde für ppProperties übergeben. |
Bemerkungen
Mit dieser Methode können Sie die Werte mehrerer Eigenschaften abrufen, z. B. die Sensorerstellung, das Modell und die Seriennummer, indem Sie einen einzelnen Aufruf ausführen. Rufen Sie zum Abrufen einer einzelnen Eigenschaft ISensor::GetProperty auf.
Die IPortableDeviceKeyCollection - und IPortableDeviceValues-Schnittstellen werden von der Windows Portable Devices-API definiert.
Examples
Ein Beispiel zum Abrufen von Eigenschaften von einem Sensor finden Sie unter Einstellung und Abrufen von Sensoreigenschaften.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 7 [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Nicht unterstützt |
| Zielplattform | Fenster |
| Header | sensorsapi.h |
| Library | Sensorsapi.lib |
| DLL | Sensorsapi.dll |