Condividi tramite

Oggetto Device

  • Articolo

L'oggetto dispositivo supporta le proprietà seguenti. Un'applicazione può richiedere queste proprietà eseguendo una query sull'oggetto radice (specificando l'ID oggetto costante definito WPD_DEVICE_OBJECT_ID). Tutti i valori dell'oggetto dispositivo sono di sola lettura.

Se un determinato dispositivo implementa la categoria WPD_FUNCTIONAL_CATEGORY_DEVICE, deve supportare anche le proprietà associate a tale categoria.

Nome proprietà Obbligatorio o facoltativo
WPD_OBJECT_ID Obbligatorio. Il valore è WPD_DEVICE_OBJECT_ID.
WPD_OBJECT_PARENT_ID Obbligatorio. Il valore è una stringa vuota.
WPD_OBJECT_NAME Obbligatorio se l'oggetto rappresenta un file.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Obbligatorio.
WPD_OBJECT_ISHIDDEN Obbligatorio se l'oggetto dispositivo non deve essere visualizzato all'utente.
WPD_OBJECT_REFERENCES Obbligatorio se l'oggetto dispositivo contiene riferimenti ad altri oggetti.
WPD_OBJECT_KEYWORDS Opzionale.
WPD_OBJECT_SYNC_ID Opzionale.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Opzionale.
WPD_DEVICE_SYNC_PARTNER Opzionale.
WPD_DEVICE_FIRMWARE_VERSION Obbligatorio.
WPD_DEVICE_POWER_LEVEL Consigliato se il dispositivo ha una batteria.
WPD_DEVICE_POWER_SOURCE Raccomandato.
WPD_DEVICE_PROTOCOL Raccomandato.
WPD_DEVICE_MANUFACTURER Obbligatorio.
WPD_DEVICE_MODEL Obbligatorio.
WPD_DEVICE_SERIAL_NUMBER Obbligatorio.
WPD_DEVICE_SUPPORTS_NON_CONSUMABLE Obbligatorio se il dispositivo supporta oggetti non di consumo; ovvero, se può essere usato per l'archiviazione dei dati semplice.
WPD_DEVICE_DATETIME Opzionale.
WPD_DEVICE_FRIENDLY_NAME Raccomandato.
WPD_DEVICE_SUPPORTED_DRM_SCHEME Consigliato se il dispositivo supporta Digital Rights Management (DRM).
WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED Consigliato se il dispositivo supporta l'ordinamento del formato preferito.
WPD_DEVICE_TYPE Raccomandato.
WPD_DEVICE_FUNCTIONAL_UNIQUE_ID Opzionale.
WPD_DEVICE_MODEL_UNIQUE_ID Opzionale.
WPD_DEVICE_TRANSPORT Raccomandato.
WPD_DEVICE_USE_DEVICE_STAGE Opzionale.
WPD_FUNCTIONAL_OBJECT_CATEGORY Obbligatorio.

Risorse tipiche

Questi oggetti in genere non ospitano risorse.

Comandi

Oltre alle proprietà, i dispositivi devono supportare un set specifico di comandi definiti dai dispositivi portatili Windows. I comandi supportati da un oggetto o dispositivo dipendono dal tipo, dalla funzionalità e dalle funzionalità.

Nella tabella seguente vengono descritte le classi di comandi applicabili ai dispositivi, in base alle funzionalità. In genere, un dispositivo rientra in diverse categorie e deve supportare i comandi per tutte le categorie applicabili. Ad esempio, un telefono cellulare con una fotocamera rientra in tre categorie: tutti i dispositivi, i dispositivi SMS e ancora i dispositivi di acquisizione immagini. Un driver personalizzato e un'applicazione client possono supportare comandi o proprietà aggiuntivi definiti dall'utente, ma devono supportare i comandi seguenti. Per una descrizione dei comandi specifici che rientrano in ogni categoria di comandi, vedere Comandi.

Descrizione Categorie di comandi
Tutti i dispositivi. 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
Dispositivi che possono acquisire immagini ancora, ad esempio fotocamere digitali. WPD_CATEGORY_STILL_IMAGE_CAPTURE
Dispositivi che possono inviare messaggi SMS (Short Message Service), ad esempio telefoni cellulari. L'invio di messaggi SMS viene spesso definito "messaggistica di testo". WPD_CATEGORY_SMS
Dispositivi che funzionano come dispositivi di archiviazione. Queste includono unità esterne. Se un dispositivo supporta la possibilità di formattare un archivio o spostare oggetti da una posizione a un'altra, il driver deve supportare questa categoria.
 WPD_CATEGORY_STORAGE

requisiti per gli oggetti