Proprietà del dispositivo (PortableDevice.h)
I dispositivi portatili Windows supportano le proprietà del dispositivo seguenti.
| Proprietà | VarType | Descrizione |
|---|---|---|
| WPD_DEVICE_DATETIME | VT_DATE | Data e ora correnti nel dispositivo. |
| WPD_DEVICE_FIRMWARE_VERSION | VT_LPWSTR | Versione del firmware del dispositivo. |
| WPD_DEVICE_FUNCTIONAL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificatore univoco a 16 byte comune in più trasporti supportati dal dispositivo. Se un singolo dispositivo supporta più trasporti, questa proprietà può essere usata per associare i vari driver WPD di trasporto a tale dispositivo. |
| WPD_DEVICE_MANUFACTURER | VT_LPWSTR | Nome del produttore del dispositivo leggibile. |
| WPD_DEVICE_MODEL | VT_LPWSTR | Modello del dispositivo. |
| WPD_DEVICE_MODEL_UNIQUE_ID | VT_VECTOR | VT_UI1 | Identificatore univoco a 16 byte usato per distinguere tra diversi modelli di un dispositivo. |
| WPD_DEVICE_NETWORK_IDENTIFIER | VT_UI8 | Valore che specifica l'identificatore di rete EUI-64 del dispositivo; questa proprietà viene usata per le operazioni di rete fuori banda. Se il dispositivo ha indirizzi di rete fisica MAC-48 (tipico delle reti IPv4), l'indirizzo MAC-48 viene codificato nell'indirizzo EUI-64 come due metà dell'indirizzo MAC-48 separato da FF-FF. Il valore EUI-64 viene archiviato in ordine "network" o "big-endian", dove un indirizzo EUI-64 pari a 01-02-03-FF-FF-04-05-06 verrà inserito nel VT_UI8 in modo che il valore decimale sia 72624942021346566. Questa proprietà è necessaria in qualsiasi dispositivo che supporta l'autenticazione nominale o sicura. Questa proprietà è consigliata nei dispositivi che supportano solo Zero Authentication. Il valore può essere usato dall'host per stabilire automaticamente l'accesso al dispositivo senza intervento dell'utente. |
| WPD_DEVICE_POWER_LEVEL | VT_UI4 | Valore compreso tra 0 e 100 che specifica il livello di potenza della batteria del dispositivo, con 0 none e 100 completamente carica. |
| WPD_DEVICE_POWER_SOURCE | VT_UI4 | Enumerazione WPD_POWER_SOURCES che specifica la fonte di alimentazione del dispositivo. |
| WPD_DEVICE_PROTOCOL | VT_LPWSTR | Protocollo del dispositivo usato. |
| WPD_DEVICE_SERIAL_NUMBER | VT_LPWSTR | Numero di serie del dispositivo. |
| WPD_DEVICE_SUPPORTED_DRM_SCHEMES | VT_UNKNOWN | Valore che specifica se i formati supportati restituiti dal dispositivo sono in un ordine preferito. Il primo formato nell'elenco è più preferito dal dispositivo, mentre l'ultimo è il meno preferito. Le applicazioni possono usare questa proprietà per determinare se i formati supportati di un dispositivo sono elencati in un ordine preferito. |
| WPD_DEVICE_SUPPORTED_FORMATS_ARE_ORDERED | VT_BOOL | Valore booleano che specifica se i formati supportati restituiti dal dispositivo sono in un ordine preferito; ovvero, il primo formato restituito è più preferito mentre l'ultimo formato restituito è meno preferito. |
| WPD_DEVICE_SUPPORTS_NON_CONSUMABLE | VT_BOOL | Valore booleano che specifica se il dispositivo supporta oggetti non consumabili. Questi sono oggetti che il dispositivo è destinato solo a archiviare, non riprodurre o usare in alcun modo. |
| WPD_DEVICE_SYNC_PARTNER | VT_LPWSTR | Descrizione leggibile del partner di sincronizzazione di un dispositivo. Si tratta di un dispositivo, un'applicazione o un server con cui il dispositivo comunica per mantenere uno stato comune o un gruppo di file tra entrambi i partner. Gli esempi includono programmi di posta elettronica e librerie musicali. |
| WPD_DEVICE_FRIENDLY_NAME | VT_LPWSTR | Valore che rappresenta il nome descrittivo impostato dall'utente nel dispositivo. |
| WPD_DEVICE_TRANSPORT | VT_UI4 | il trasporto supportato dal dispositivo, ad esempio USB, IP o Bluetooth. I valori validi sono del tipo di enumerazione WPD_DEVICE_TRANSPORTS . |
| WPD_DEVICE_TYPE | VT_UI4 | Valore che specifica il tipo di dispositivo; le applicazioni usano questa proprietà solo a scopo di rappresentazione. Le caratteristiche funzionali del dispositivo vengono definite tramite oggetti funzionali. I dispositivi che non forniscono un'icona del dispositivo, ad esempio un WPD_RESOURCE_ICON per l'oggetto dispositivo, verranno rappresentati nello spazio dei nomi WPD con un'icona generica. Questa icona dipenderà dal tipo di dispositivo specificato, ad esempio se il tipo di dispositivo è un telefono cellulare, viene usata l'icona del telefono generico. Al primo installazione del dispositivo, il programma di installazione della classe WPD eseguirà una query su questo valore della proprietà e lo archivierà nel Registro di sistema del dispositivo sotto il valore PORTABLE_DEVICE_TYPE come REG_DWORD. I valori possibili di questo parametro provengono dall'enumerazione WPD_DEVICE_TYPES definita in PortableDevice.h. I valori possibili sono:
WPD_DEVICE_TYPE_CAMERA WPD_DEVICE_TYPE_MEDIA_PLAYER WPD_DEVICE_TYPE_PHONE WPD_DEVICE_TYPE_VIDEO WPD_DEVICE_TYPE_PERSONAL_INFORMATION_MANAGER WPD_DEVICE_TYPE_AUDIO_RECORDER |
| WPD_DEVICE_USE_DEVICE_STAGE | VT_BOOL | Se questa proprietà esiste ed è impostata su TRUE, il dispositivo può essere usato con Device Stage . Ciò è destinato ai dispositivi che non possono archiviare i metadati usando il servizio metadati del dispositivo, ma forniranno metadati nei server Microsoft. |
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|