Device-Objekt

Das Geräteobjekt unterstützt die folgenden Eigenschaften. Eine Anwendung kann diese Eigenschaften anfordern, indem sie das Stammobjekt abfragen (angeben der definierten WPD_DEVICE_OBJECT_ID Konstantenobjekt-ID). Alle Werte des Geräteobjekts sind schreibgeschützt.

Wenn ein bestimmtes Gerät die kategorie WPD_FUNCTIONAL_CATEGORY_DEVICE implementiert, muss es auch die Eigenschaften unterstützen, die dieser Kategorie zugeordnet sind.

Eigenschaftsname	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 hat.
WPD_OBJECT_KEYWORDS	Wahlfrei.
WPD_OBJECT_SYNC_ID	Wahlfrei.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE	Wahlfrei.
WPD_DEVICE_SYNC_PARTNER	Wahlfrei.
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 konsumierbare Objekte unterstützt; das heißt, wenn sie für die einfache Datenspeicherung verwendet werden kann.
WPD_DEVICE_DATETIME	Wahlfrei.
WPD_DEVICE_FRIENDLY_NAME	Empfohlen.
WPD_DEVICE_SUPPORTED_DRM_SCHEME	Empfohlen, wenn das Gerät die Verwaltung digitaler Rechte (Digital Rights Management, DRM) unterstützt.
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED	Empfohlen, wenn das Gerät die bevorzugte Formatbestellung unterstützt.
WPD_DEVICE_TYPE	Empfohlen.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID	Wahlfrei.
WPD_DEVICE_MODEL_UNIQUE_ID	Wahlfrei.
WPD_DEVICE_TRANSPORT	Empfohlen.
WPD_DEVICE_USE_DEVICE_STAGE	Wahlfrei.
WPD_FUNCTIONAL_OBJECT_CATEGORY	Erforderlich.

Typische Ressourcen

Diese Objekte hosten in der Regel keine Ressourcen.

Befehle

Zusätzlich zu 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 sollte die Befehle für alle anwendbaren Kategorien unterstützen. Beispielsweise würde ein Mobiltelefon mit einer Kamera unter drei Kategorien fallen: alle Geräte, SMS-Geräte und weiterhin Bildaufnahmegeräte. Eine benutzerdefinierte Treiber- und Clientanwendung kann 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 Commands.

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 stille Bilder 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 "Textnachrichten" bezeichnet.	WPD_CATEGORY_SMS
Geräte, die als Speichergeräte funktionieren. Dazu gehören externe Laufwerke. Wenn ein Gerät die Möglichkeit zum Formatieren eines Speichers oder zum Verschieben von Objekten von einem Speicherort zu einem anderen unterstützt, sollte Ihr Treiber diese Kategorie unterstützen.	WPD_CATEGORY_STORAGE

Verwandte Themen

Anforderungen für Objekte