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 KATEGORIE WPD _ FUNCTIONAL CATEGORY _ _ DEVICE implementiert, muss es auch die Eigenschaften unterstützen, die dieser Kategorie zugeordnet sind.
| Eigenschaftsname | Erforderlich oder optional |
|---|---|
| _WPD-OBJEKT-ID _ | Erforderlich. Der Wert ist WPD _ DEVICE OBJECT _ _ ID. |
| ÜBERGEORDNETE ID DES _ _ WPD-OBJEKTS _ | Erforderlich. Der Wert ist eine leere Zeichenfolge. |
| _WPD-OBJEKTNAME _ | Erforderlich, wenn das -Objekt eine Datei darstellt. |
| PERSISTENTE EINDEUTIGE ID _ DES WPD-OBJEKTS _ _ _ | Erforderlich. |
| _WPD-OBJEKT _ ISHIDDEN | Erforderlich, wenn das Geräteobjekt dem Benutzer nicht angezeigt werden soll. |
| _ _ WPD-OBJEKTVERWEISE | Erforderlich, wenn das Geräteobjekt Verweise auf andere Objekte enthält. |
| _WPD-OBJEKTSCHLÜSSELWÖRTER _ | Optional. |
| _ _ WPD-OBJEKTSYNCHRONISIERUNGS-ID _ | Optional. |
| _WPD-OBJEKT _ GENERIERT _ _ MINIATURANSICHT AUS _ RESSOURCE | Optional. |
| _ _ WPD-GERÄTESYNCHRONISIERUNGSPARTNER _ | Optional. |
| _ _ WPD-GERÄTEFIRMWAREVERSION _ | Erforderlich. |
| _ _ _ WPD-GERÄTELEISTUNGSSTUFE | Empfohlen, wenn das Gerät über einen Akku verfügt. |
| _ _ WPD-GERÄTESTROMQUELLE _ | Empfohlen. |
| _WPD-GERÄTEPROTOKOLL _ | Empfohlen. |
| _WPD-GERÄTEHERSTELLER _ | Erforderlich. |
| _WPD-GERÄTEMODELL _ | Erforderlich. |
| _ _ WPD-GERÄTESERIENNUMMER _ | Erforderlich. |
| _WPD-GERÄT _ UNTERSTÜTZT NICHT _ VERWENDBARE _ GERÄTE | Erforderlich, wenn das Gerät nicht gebrauchsbare Objekte unterstützt. Das heißt, wenn es für die einfache Datenspeicherung verwendet werden kann. |
| WPD _ DEVICE _ DATETIME | Optional. |
| _WPD-GERÄTE-FRIENDLY _ _ NAME | Empfohlen. |
| VOM _ WPD-GERÄT _ _ UNTERSTÜTZTES DRM-SCHEMA _ | Empfohlen, wenn das Gerät Digital Rights Management (DRM) unterstützt. |
| VOM _ _ WPD-GERÄT _ UNTERSTÜTZTE FORMATE _ WERDEN _ GEORDNET. | Empfohlen, wenn das Gerät die bevorzugte Formatbestellung unterstützt. |
| _WPD-GERÄTETYP _ | Empfohlen. |
| WPD _ DEVICE _ FUNCTIONAL _ UNIQUE _ ID | Optional. |
| EINDEUTIGE ID _ DES WPD-GERÄTEMODELLS _ _ _ | Optional. |
| _WPD-GERÄTETRANSPORT _ | Empfohlen. |
| WPD _ DEVICE _ USE _ DEVICE _ STAGE | Optional. |
| WPD _ FUNCTIONAL _ OBJECT _ CATEGORY | Erforderlich. |
Typische Ressourcen
Diese Objekte hosten in der Regel keine Ressourcen.
Befehle
Zusätzlich zu den Eigenschaften sollten Geräte einen bestimmten Satz von Befehlen unterstützen, die von portierbaren Windows 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 nach Funktionalität gelten. In der Regel fällt ein Gerät in mehrere Kategorien und sollte die Befehle für alle anwendbaren Kategorien unterstützen. Beispielsweise würde ein Mobiltelefon mit einer Kamera in drei Kategorien fallen: alle Geräte, SMS-Geräte und Noch-Bilderfassungsgerä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 die einzelnen Befehlskategorien 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 Stillbilder erfassen 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 funktionieren. Dazu gehören externe Laufwerke. Wenn ein Gerät die Möglichkeit unterstützt, einen Speicher zu formatieren oder Objekte von einem Standort an einen anderen zu verschieben, sollte Ihr Treiber diese Kategorie unterstützen. |
WPD _ CATEGORY _ STORAGE |