Enhetsobjekt
Enhetsobjektet stöder följande egenskaper. Ett program kan begära dessa egenskaper genom att fråga rotobjektet (ange det definierade WPD_DEVICE_OBJECT_ID konstant objekt-ID). Alla värden för enhetsobjektet är skrivskyddade.
Om en viss enhet implementerar kategorin WPD_FUNCTIONAL_CATEGORY_DEVICE måste den också ha stöd för de egenskaper som är associerade med den kategorin.
| Egenskapsnamn | Obligatoriskt eller valfritt |
|---|---|
| WPD_OBJECT_ID | Krävs. Värdet är WPD_DEVICE_OBJECT_ID. |
| WPD_OBJECT_PARENT_ID | Krävs. Värdet är en tom sträng. |
| WPD_OBJECT_NAME | Krävs om objektet representerar en fil. |
| WPD_OBJECT_PERSISTENT_UNIQUE_ID | Krävs. |
| WPD_OBJECT_ISHIDDEN | Krävs om enhetsobjektet inte ska visas för användaren. |
| WPD_OBJECT_REFERENCES | Krävs om enhetsobjektet har referenser till andra objekt. |
| WPD_OBJECT_KEYWORDS | Valfri. |
| WPD_OBJECT_SYNC_ID | Valfri. |
| WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE | Valfri. |
| WPD_DEVICE_SYNC_PARTNER | Valfri. |
| WPD_DEVICE_FIRMWARE_VERSION | Krävs. |
| WPD_DEVICE_POWER_LEVEL | Rekommenderas om enheten har ett batteri. |
| WPD_DEVICE_POWER_SOURCE | Rekommenderad. |
| WPD_DEVICE_PROTOCOL | Rekommenderad. |
| WPD_DEVICE_MANUFACTURER | Krävs. |
| WPD_DEVICE_MODEL | Krävs. |
| WPD_DEVICE_SERIAL_NUMBER | Krävs. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | Krävs om enheten stöder icke-förbrukningsbara objekt. om den kan användas för enkel datalagring. |
| WPD_DEVICE_DATETIME | Valfri. |
| WPD_DEVICE_FRIENDLY_NAME | Rekommenderad. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEME | Rekommenderas om enheten stöder Digital Rights Management (DRM). |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | Rekommenderas om enheten stöder önskad formatordning. |
| WPD_DEVICE_TYPE | Rekommenderad. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | Valfri. |
| WPD_DEVICE_MODEL_UNIQUE_ID | Valfri. |
| WPD_DEVICE_TRANSPORT | Rekommenderad. |
| WPD_DEVICE_USE_DEVICE_STAGE | Valfri. |
| WPD_FUNCTIONAL_OBJECT_CATEGORY | Krävs. |
Vanliga resurser
Dessa objekt är vanligtvis inte värd för resurser.
Kommandon
Förutom egenskaper bör enheterna ha stöd för en specifik uppsättning kommandon som definierats av Bärbara Windows-enheter. Vilka kommandon ett objekt eller en enhet stöder beror på dess typ, funktioner och funktioner.
I följande tabell beskrivs de kommandoklasser som gäller för enheter, efter funktionalitet. Vanligtvis faller en enhet under flera kategorier och bör ha stöd för kommandona för alla tillämpliga kategorier. Till exempel skulle en mobiltelefon med en kamera omfattas av tre kategorier: alla enheter, SMS-enheter och enheter för stillbildsbilder. En anpassad drivrutin och ett klientprogram kan ha stöd för ytterligare kommandon eller egenskaper som du definierar, men måste ha stöd för följande kommandon. En beskrivning av de specifika kommandon som hör till varje kommandokategori finns i Kommandon.
| Beskrivning | Kommandokategorier |
|---|---|
| Alla enheter. |
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 |
| Enheter som kan ta stillbilder, till exempel digitalkameror. | WPD_CATEGORY_STILL_IMAGE_CAPTURE |
| Enheter som kan skicka sms-meddelanden (short message service), till exempel mobiltelefoner. Att skicka SMS kallas ofta "sms". | WPD_CATEGORY_SMS |
| Enheter som fungerar som lagringsenheter. Dessa inkluderar externa enheter. Om en enhet stöder möjligheten att formatera ett arkiv eller flytta objekt från en plats till en annan bör drivrutinen ha stöd för den här kategorin. |
WPD_CATEGORY_STORAGE |