Geräteobjekt
Das Geräteobjekt unterstützt die folgenden Eigenschaften. Eine Anwendung kann diese Eigenschaften anfordern, indem sie das Stammobjekt abfragt (unter Angabe der definierten WPD_DEVICE_OBJECT_ID konstanten Objekt-ID). Alle Werte des Geräteobjekts sind schreibgeschützt.
Wenn ein bestimmtes Gerät die WPD_FUNCTIONAL_CATEGORY_DEVICE-Kategorie implementiert, muss es auch die eigenschaften unterstützen, die dieser Kategorie zugeordnet sind.
| Eigenschaftenname | Erforderlich oder optional |
|---|---|
| WPD_OBJECT_ID | Erforderlich. Der Wert ist WPD_DEVICE_OBJECT_ID. |
| WPD_OBJECT_PARENT_ID | Erforderlich. Der Wert ist eine leere Zeichenfolge. |
| WPD_OBJECT_NAME | Erforderlich, wenn das Objekt eine Datei darstellt. |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Erforderlich. |
| WPD_OBJECT_ISHIDDEN | Erforderlich, wenn das Geräteobjekt dem Benutzer nicht angezeigt werden soll. |
| WPD_OBJECT_REFERENCES | Erforderlich, wenn das Geräteobjekt Verweise auf andere Objekte aufweist. |
| WPD_OBJECT_KEYWORDS | Optional. |
| WPD_OBJECT_SYNC_ID | Optional. |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Optional. |
| WPD_DEVICE_SYNC_PARTNER | Optional. |
| WPD_DEVICE_FIRMWARE_VERSION | Erforderlich. |
| WPD_DEVICE_POWER_LEVEL | Empfohlen, wenn das Gerät über einen Akku verfügt. |
| WPD_DEVICE_POWER_SOURCE | Empfohlen. |
| WPD_DEVICE_PROTOCOL | Empfohlen. |
| WPD_DEVICE_MANUFACTURER | Erforderlich. |
| WPD_DEVICE_MODEL | Erforderlich. |
| WPD_DEVICE_SERIAL_NUMBER | Erforderlich. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | Erforderlich, wenn das Gerät nicht verbrauchsbare Objekte unterstützt; das heißt, wenn sie für die einfache Datenspeicherung verwendet werden kann. |
| WPD_DEVICE_DATETIME | Optional. |
| WPD_DEVICE_FRIENDLY_NAME | Empfohlen. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEME | Empfohlen, wenn das Gerät Digital Rights Management (DRM) unterstützt. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | Empfohlen, wenn das Gerät die bevorzugte Formatreihenfolge unterstützt. |
| WPD_DEVICE_TYPE | Empfohlen. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | Optional. |
| WPD_DEVICE_MODEL_UNIQUE_ID | Optional. |
| WPD_DEVICE_TRANSPORT | Empfohlen. |
| WPD_DEVICE_USE_DEVICE_STAGE | Optional. |
| WPD_FUNCTIONAL_OBJECT_CATEGORY | Erforderlich. |
Typische Ressourcen
Diese Objekte hosten normalerweise keine Ressourcen.
Befehle
Zusätzlich zu den Eigenschaften sollten Geräte einen bestimmten Satz von Befehlen unterstützen, die von Tragbaren Windows-Geräten definiert werden. Welche Befehle ein Objekt oder Gerät unterstützt, hängt vom Typ, der Funktionalität und den Funktionen ab.
In der folgenden Tabelle werden die Befehlsklassen beschrieben, die für Geräte gelten, nach Funktionalität. In der Regel fällt ein Gerät unter mehrere Kategorien, und es sollte die Befehle für alle anwendbaren Kategorien unterstützen. Ein Mobiltelefon mit Kamera würde beispielsweise unter drei Kategorien fallen: alle Geräte, SMS-Geräte und Standbilderfassungsgeräte. Ein benutzerdefinierter Treiber und eine Clientanwendung können zusätzliche Befehle oder Eigenschaften unterstützen, die Sie definieren, müssen jedoch die folgenden Befehle unterstützen. Eine Beschreibung der spezifischen Befehle, die unter jede Befehlskategorie fallen, finden Sie unter Befehle.
| Beschreibung | Befehlskategorien |
|---|---|
| Alle Geräte. |
WPD_CATEGORY_CAPABILITIESWPD_CATEGORY_COMMON WPD_CATEGORY_OBJECT_ENUMERATION WPD_CATEGORY_OBJECT_MANAGEMENT WPD_CATEGORY_OBJECT_PROPERTIES WPD_CATEGORY_OBJECT_PROPERTIES_BULK WPD_CATEGORY_OBJECT_RESOURCES |
| Geräte, die Standbilder aufnehmen können, z. B. Digitalkameras. | WPD_CATEGORY_STILL_IMAGE_CAPTURE |
| Geräte, die SMS-Nachrichten (Short Message Service) senden können, z. B. Mobiltelefone. Das Senden von SMS-Nachrichten wird häufig als "SMS" bezeichnet. | WPD_CATEGORY_SMS |
| Geräte, die als Speichergeräte fungieren. Dazu gehören externe Laufwerke. Wenn ein Gerät die Möglichkeit unterstützt, einen Speicher zu formatieren oder Objekte von einem Speicherort an einen anderen zu verschieben, sollte ihr Treiber diese Kategorie unterstützen. |
WPD_CATEGORY_STORAGE |