Costanti di metadati
I metadati sono informazioni descrittive sul contenuto trasferito da o verso un dispositivo. In Gestione dispositivi di Windows Media i metadati sono costituiti da proprietà, in cui ogni proprietà è una coppia nome-valore. Il nome è sempre una stringa di caratteri wide. Il valore è uno dei diversi tipi di dati definiti descritti nell'enumerazione WMDM_TAG_DATATYPE.
Windows Media Device Manager ha proprietà comuni predefinite ed è consigliabile usarle invece definendone di nuove. Per ogni proprietà predefinita, l'SDK definisce una costante globale che contiene la stringa del nome. È possibile ridurre la probabilità di errori tipografici usando la costante globale. Ad esempio, la costante g_wszWMDMTitle è definita come "Title", corrispondente alla proprietà Title.
In questo SDK sono state definite le costanti delle proprietà dei metadati seguenti. Questi sono definiti in mswmdm.h.
Costanti dei metadati di archiviazione
| Proprietà di archiviazione | Descrizione | Tipo di Gestione dispositivi Windows Media | di tipo sottostante |
|---|---|---|---|
| g_wszAudioWAVECodec | Codec audio | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Codec video | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Indica se il dispositivo supporta o meno l'album art | WMDM_TYPE_BOOL | bool |
| g_wszWMDMAlbumArtist | Artisti di Track's Album | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | BLOB di byte JPEG dell'album | WMDM_TYPE_BINARY | byte* |
| g_wszWMDMAlbumCoverDuration | Durata copertina album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Formato dell'immagine dell'album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Altezza dell'arte dell'album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Dimensioni dell'immagine dell'album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Larghezza dell'arte dell'album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Titolo album della traccia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profondità bit audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Riferimento all'oggetto contenitore. Ad esempio, un oggetto audio userebbe questa proprietà per fare riferimento a una playlist. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Autore del contenuto | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Data di creazione del contenuto | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMBitrate | Velocità in bit audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | Tipo di velocità in bit MTP. Attualmente non implementato.I valori validi sono: MTP_BITRATETYPE_DISCRETE (0x001) che indica che sono supportati CBR e un set discreto di velocità di bit. MTP_BITRATETYPE_VARIABLE (0x0002) che indica il supporto per VBR. MTP_BITRATE_TYPE_FREE (0x0003) che indica che i valori CBR e velocità in bit sono continui su un intervallo specificato. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Allineamento blocchi | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Dimensioni buffer | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Acquista questo album (obbligatorio per l'arte dell'album) | WMDM_TYPE_BOOL | bool |
| g_wszWMDMByteBookmark | Segnalibro che identifica l'ultima posizione riprodotta o visualizzata in un oggetto multimediale. Questo segnalibro è un offset di byte in base zero. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Campo di testo che indica il genere di un elemento multimediale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Riservato per uso futuro | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Compositore musicale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | Lunghezza dei dati per l'oggetto a cui si fa riferimento | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Offset in base zero per l'oggetto a cui si fa riferimento | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Unità utilizzate per la lunghezza dei dati (g_wszWMDMDataLength) e le proprietà delle unità dati (g_wszWMDMDataUnits). Si presuppone che le unità siano byte se questa proprietà non è impostata. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Serie TV o descrizione foto | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | URL associato a un oggetto . Questa proprietà viene in genere utilizzata per un oggetto media cast (o correlato). |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Riservato per uso futuro | ||
| g_wszWMDMDevicePlayCount | Numero di riproduzioni nel dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Durata media, in 100 unità ns | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | Indirizzo di posta elettronica per l'editor di gestione associato a un oggetto multimediale. Questa proprietà viene in genere utilizzata per identificare l'editor di gestione per un canale RSS. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | I profili di codifica WMV9 supportati da un dispositivo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Attributi per un oggetto file | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Musica, video, audio non musicale, altro | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Data di creazione file | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nome file. Equivale a chiamare IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Dimensioni del file, in byte. Equivale a chiamare IWMDMStorage::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Formattare il codice per il formato del contenuto. Deve essere un valore WMDM_FORMATCODE. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Frequenza dei fotogrammi | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Genere di Track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Altezza video o immagine | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Indica se il contenuto è protetto da DRM | WMDM_TYPE_BOOL | bool |
| g_wszWMDMIsRepeat | Vero se non è la prima volta che l'episodio è stato trasmesso | WMDM_TYPE_BOOL | bool |
| g_wszWMDMKeyFrameDistance | Distanza fotogramma chiave | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Data/ora dell'ultima modifica del file. Equivale a chiamare IWMDMStorage::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Audiobook, video musicali, parlare radio e così via | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Crediti TV (attori, regista, produttori) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Identificatore univoco globale per il contenuto multimediale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Data in cui è stato trasmesso per la prima volta l'episodio | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Canale da cui è stato registrato l'episodio | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Lettere di chiamata o nome della stazione TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo di contenuto derivato dall'ID classe primaria & secondario | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Indica se il contenuto viene archiviato come BLOB di dati opaco nel dispositivo. In tal caso, il dispositivo non deve comprendere il formato o eseguirne il rendering. | WMDM_TYPE_BOOL | bool |
| g_wszWMDMNumChannels | Numero di canali | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Segnalibro (in millisecondi) che specifica l'ultima posizione nell'oggetto multimediale riprodotto o visualizzato | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | Indirizzo di posta elettronica per il proprietario di un oggetto multimediale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Valutazione consultiva | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | ID univoco generato dal dispositivo per l'archiviazione | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Conteggio totale della riproduzione di file | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Nome del titolare del copyright | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Impostazione di qualità | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Frequenza di campionamento | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Tipo di analisi | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | URL di origine per un oggetto multimediale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Titolo dell'episodio TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | Descrizione dell'episodio tv | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | GUID generato dall'applicazione a scopo di sincronizzazione | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Timestamp del dispositivo quando viene copiato | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Segnalibro (in millisecondi) che specifica l'ultima posizione riprodotta o visualizzata | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Tempo (in minuti) fino a quando il contenuto non viene aggiornato | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Titolo traccia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Velocità in bit totale | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Numero traccia (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Umore di Track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calcolato da utenti, classificazioni del servizio e conteggio dei giochi | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Ultimo timestamp ascoltato o visualizzato | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Classificazione impostata dall'utente | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Valutazione impostata dall'utente modificata nel dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Velocità in bit video | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | L'indirizzo di posta elettronicadeloe responsabile di un oggetto multimediale | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Larghezza video o immagine | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Anno in cui è stato pubblicato l'album | WMDM_TYPE_STRING | LPCWSTR |
Costanti dei metadati del dispositivo
| Proprietà device | Descrizione | PropVARIANT type(vt) | Commenti |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Matrice di nomi di proprietà per le proprietà supportate dal dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nome descrittivo del dispositivo | VT_BSTR | |
| g_wszWMDMFormatsSupported | Matrice di codici di formato per i formati supportati dal dispositivo | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Indica se il formato restituito nella matrice dei formati supportati viene ordinato in base alle preferenze del dispositivo. Se questa proprietà è impostata su TRUE, le applicazioni devono trasferire il contenuto usando i codici di formato visualizzati per primi nella matrice. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | ID relazione di sincronizzazione usato dall'applicazione | VT_BSTR | |
| g_wszWMDMDeviceModelName | Nome del modello di dispositivo | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Versione del firmware | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Estensione fornitore supportata dal dispositivo | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protocollo usato per la comunicazione tra host e dispositivo | VT_CLSID | I valori predefiniti sono:WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | ID del fornitore che fornisce un provider di servizi windows Media Device Manager per il dispositivo | VT_CLSID | I valori predefiniti sono:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Riservato per uso futuro. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Informazioni di revoca per un dispositivo. Queste informazioni includono elementi come l'URL di revoca. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Matrice di nomi di proprietà per le proprietà supportate dal dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nome descrittivo del dispositivo | VT_BSTR |
Costanti dei metadati dei dispositivi portatili Windows
| Proprietà Dispositivi portatili Windows | Descrizione | PropVARIANT type(vt) | Commenti |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Oggetto binario di grandi dimensioni (o BLOB) utilizzato per impostare o recuperare le proprietà dei dispositivi portatili Windows | WMDM_TYPE_BINARY | Consente ai client windows Media Device Manager di leggere e scrivere proprietà dei dispositivi portatili Windows non trovate in Gestione dispositivi multimediali Windows. Si noti che alcune proprietà del dispositivo portatile Windows potrebbero non essere accessibili. |