WPD_CONTENT_TYPE_FUNCTIONAL_OBJECT

  • Articolo

Oggetto che descrive il relativo tipo come WPD_CONTENT_FUNCTIONAL_OBJECT rappresenta un oggetto funzionale, incapsulando la funzionalità del dispositivo.

Tutti gli oggetti funzionali, indipendentemente dal tipo, supportano le proprietà seguenti. Se si definisce un oggetto funzionale personalizzato, deve supportare anche queste proprietà.

Nome proprietà Obbligatorio o facoltativo
WPD_OBJECT_ID Obbligatorio, di sola lettura. Un client non può impostare questa proprietà, anche in fase di creazione.
WPD_OBJECT_PARENT_ID Obbligatorio.
WPD_OBJECT_NAME Obbligatorio.
WPD_OBJECT_PERSISTENT_UNIQUE_ID Obbligatorio, di sola lettura. Un client non può impostare questa proprietà, anche in fase di creazione.
WPD_OBJECT_FORMAT Obbligatorio.
WPD_OBJECT_CONTENT_TYPE Obbligatorio.
WPD_OBJECT_ISHIDDEN Obbligatorio se l'oggetto è nascosto.
WPD_OBJECT_ISSYSTEM Obbligatorio se l'oggetto è un oggetto di sistema (rappresenta un file di sistema).
WPD_OBJECT_SIZE Obbligatorio se l'oggetto ha almeno una risorsa.
WPD_OBJECT_ORIGINAL_FILE_NAME Obbligatorio se l'oggetto rappresenta un file.
WPD_OBJECT_NON_CONSUMABLE Consigliato se l'oggetto non è destinato al consumo dal dispositivo.
WPD_OBJECT_REFERENCES Obbligatorio se l'oggetto ha riferimenti ad altri oggetti.
WPD_OBJECT_KEYWORDS Facoltativa.
WPD_OBJECT_SYNC_ID Facoltativa.
WPD_OBJECT_IS_DRM_PROTECTED Obbligatorio se l'oggetto è protetto dalla tecnologia DRM.
WPD_OBJECT_DATE_CREATED Facoltativa.
WPD_OBJECT_DATE_MODIFIED Consigliato.
WPD_OBJECT_DATE_AUTHORED Facoltativa.
WPD_OBJECT_BACK_REFERENCES Consigliato se l'oggetto viene fatto riferimento a un altro oggetto.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID Facoltativa.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE Facoltativa.
WPD_OBJECT_CAN_DELETE Obbligatorio se l'oggetto non può essere eliminato.
WPD_OBJECT_LANGUAGE_LOCALE Facoltativa.
WPD_FUNCTIONAL_OBJECT_CATEGORY Obbligatorio. Vedere la tabella seguente per le categorie definite dai dispositivi portatili Windows.

 

Risorse tipiche

Questi oggetti in genere non ospitano risorse.

Categorie di oggetti funzionali

Gli oggetti funzionali possono essere raggruppati in categorie, a seconda delle relative funzioni. Una categoria è descritta dalla proprietà WPD_FUNCTIONAL_OBJECT_CATEGORY (valore GUID). La categoria determina quali proprietà aggiuntive sono supportate.

Nella tabella seguente vengono descritte le categorie definite dai dispositivi portatili Windows. Per informazioni sulle proprietà e sulle risorse aggiuntive supportate dall'oggetto, vedere la descrizione della categoria.

Categoria funzionale Descrizione
WPD_FUNCTIONAL_CATEGORY_ALL Questa categoria funzionale è valida solo come parametro per determinate funzioni di query (per indicare che tutti i tipi di oggetti funzionali sono accettabili) e non è una categoria funzionale segnalata dal driver.
WPD_FUNCTIONAL_CATEGORY_AUDIO_CAPTURE L'oggetto incapsula le funzionalità di acquisizione audio nel dispositivo, ad esempio un registratore vocale o un altro componente di registrazione audio.
WPD_FUNCTIONAL_CATEGORY_DEVICE L'oggetto incapsula il dispositivo, ovvero l'oggetto più in alto del dispositivo.
WPD_FUNCTIONAL_CATEGORY_NETWORK_CONFIGURATION L'oggetto incapsula le funzionalità di configurazione della rete per il dispositivo, ad esempio profili WiFi o partnership.
WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION L'oggetto descrive i tipi di file multimediali che il dispositivo è in grado di riprodurre.
WPD_FUNCTIONAL_CATEGORY_SMS L'oggetto incapsula la funzionalità del servizio messaggi brevi (comunemente denominata "messaggistica di testo") nel dispositivo.
WPD_FUNCTIONAL_CATEGORY_STILL_IMAGE_CAPTURE L'oggetto incapsula le funzionalità di acquisizione delle immagini in un dispositivo, ad esempio una fotocamera o un allegato della fotocamera.
WPD_FUNCTIONAL_CATEGORY_STORAGE L'oggetto incapsula l'archiviazione dei file fisici nel dispositivo.
WPD_FUNCTIONAL_CATEGORY_VIDEO_CAPTURE L'oggetto incapsula le funzionalità di acquisizione video nel dispositivo, ad esempio un componente del registratore video. Un'applicazione usa questo oggetto per ottenere il controllo a livello di codice.

 

Requisiti per gli oggetti