Constantes de métadonnées
Les métadonnées sont des informations descriptives sur le contenu transféré vers ou depuis un appareil. Dans Windows Media Device Manager, les métadonnées se composent de propriétés, où chaque propriété est une paire nom-valeur. Le nom est toujours une chaîne à caractères larges. La valeur est l’un des types de données définis décrits dans l’énumération WMDM_TAG_DATATYPE.
Windows Media Device Manager a prédéfini des propriétés courantes et il est fortement recommandé d’utiliser celles qui définissent les nouvelles. Pour chaque propriété prédéfinie, le SDK définit une constante globale qui contient la chaîne de nom. Vous pouvez réduire le risque d’erreurs typographiques à l’aide de la constante globale. Par exemple, la constante g_wszWMDMTitle est définie comme « Title », correspondant à la propriété Title.
Les constantes de propriété de métadonnées suivantes ont été définies pour être utilisées dans ce Kit de développement logiciel (SDK). Celles-ci sont définies dans mswmdm.h.
Constantes de métadonnées de stockage
| Propriété de stockage | Description | Type de Gestionnaire de périphériques Windows Media | type sous-jacent |
|---|---|---|---|
| g_wszAudioWAVECodec | Codec audio | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Codec vidéo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Indique si l’appareil prend en charge ou non l’image d’album | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Albums de track’s Artists | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Objet blob d’octets JPEG d’albums | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Durée de couverture de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Format d’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Hauteur de l’art de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Taille de l’art de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Largeur de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Titre de l’album track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profondeur du bit audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Référence à l’objet conteneur. Par exemple, un objet audio utilise cette propriété pour référencer une playlist. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Auteur de contenu | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Date de création du contenu | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMBitrate | Débit audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | Type de débit binaire MTP. (Actuellement non implémenté.)Les valeurs valides sont les suivantes : MTP_BITRATETYPE_DISCRETE (0x001) qui indique que CBR et un ensemble discret de taux de bits sont pris en charge. MTP_BITRATETYPE_VARIABLE (0x0002) qui indique la prise en charge de VBR. MTP_BITRATE_TYPE_FREE (0x0003) qui indique que les valeurs CBR et de débit binaire sont continues sur une plage spécifiée. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Alignement des blocs | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Taille de la mémoire tampon | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Acheter cet album (obligatoire pour l’album) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | Signet identifiant la dernière position lue ou affichée dans un objet multimédia. (Ce signet est un décalage d’octet de base zéro.) | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Champ de texte indiquant le genre d’un élément multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Réservé à une utilisation ultérieure | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Compositeur de musique | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | Longueur des données de l’objet référencé | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Décalage de base zéro pour l’objet référencé | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Unités utilisées pour la longueur des données (g_wszWMDMDataLength) et les propriétés d’unités de données (g_wszWMDMDataUnits). Les unités sont supposées être des octets si cette propriété n’est pas définie. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Série tv ou description de photo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | URL associée à un objet. Cette propriété est généralement utilisée pour un objet de cast multimédia (ou associé). |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Réservé à une utilisation ultérieure | ||
| g_wszWMDMDevicePlayCount | Nombre de lecture sur l’appareil | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Durée du média, en unités de 100 ns | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | Adresse e-mail de l’éditeur de gestion associé à un objet multimédia. Cette propriété est généralement utilisée pour identifier l’éditeur de gestion d’un canal RSS. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | Profils d’encodage WMV9 pris en charge par un appareil | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Attributs d’un objet de fichier | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Musique, vidéo, audio non-musique, autres | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Date de création de fichier | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nom de fichier. Équivaut à appeler IWMDMStorage ::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Taille du fichier, en octets. Équivaut à appeler IWMDMStorage ::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Format du code pour le format de contenu. Il doit s’agir d’une valeur WMDM_FORMATCODE. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Fréquence d’images | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Genre de piste | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Hauteur de la vidéo ou de l’image | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Indique si le contenu est protégé par DRM | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMIsRepeat | True si ce n’est pas la première fois que l’épisode a été diffusé | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMKeyFrameDistance | Distance de trame clé | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Le fichier date/heure a été modifié pour la dernière fois. Équivaut à appeler IWMDMStorage ::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Livres audio, vidéos musicales, parler radio, et ainsi de suite | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Crédits tv (acteurs, réalisateurs, producteurs) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Identificateur global unique pour le contenu multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Date à laquelle cet épisode a été diffusé en premier | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Canal de cet épisode a été enregistré à partir de | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Lettres d’appel ou nom de la station de télévision | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Type de contenu dérivé de l’ID de classe primaire & secondaire | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Indique si le contenu est stocké en tant qu’objet blob de données opaque sur l’appareil. Dans ce cas, l’appareil n’a pas besoin de comprendre le format ou de le restituer. | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMNumChannels | Nombre de canaux | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Signet (en millisecondes) qui spécifie la dernière position dans l’objet multimédia lu ou consulté | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | Adresse de messagerie pour le propriétaire d’un objet multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Évaluation des avis | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | ID unique généré par l’appareil pour le stockage | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Nombre total de lecture de fichiers | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Nom du titulaire du droit d’auteur | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Paramètre de qualité | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Taux d’échantillonnage | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Type d’analyse | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | URL source d’un objet multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Titre de l’épisode tv | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | Description de l’épisode tv | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | GUID généré par l’application à des fins de synchronisation | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Horodatage de l’appareil lors de la copie | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Signet (en millisecondes) qui spécifie la dernière position lue ou affichée | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Heure (en minutes) jusqu’à la mise à jour du contenu | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Titre du suivi | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Taux de bits total | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Numéro de suivi (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | L’humeur du track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculé à partir de l’utilisateur, des évaluations de service et du nombre de jeux | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Dernière écoute ou affichage de l’horodatage | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Évaluation de l’ensemble de l’utilisateur | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Modification de l’évaluation de l’ensemble de l’utilisateur sur l’appareil | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Vitesse de transmission vidéo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | Adresse de messagerie de l’administrateur responsable d’un objet multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Largeur de la vidéo ou de l’image | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Année de sortie de l’album | WMDM_TYPE_STRING | LPCWSTR |
Constantes de métadonnées d’appareil
| Propriété de l’appareil | Description | TYPE PROPVARIANT(vt) | Commentaires |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Tableau de noms de propriétés pour les propriétés prises en charge par l’appareil | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nom convivial de l’appareil | VT_BSTR | |
| g_wszWMDMFormatsSupported | Tableau de codes de format pour les formats pris en charge par l’appareil | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Indique si le format retourné dans le tableau de formats pris en charge est classé selon la préférence de l’appareil. Si cette propriété est définie sur TRUE, les applications doivent transférer du contenu à l’aide des codes de format qui apparaissent en premier dans le tableau. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | ID de relation de synchronisation utilisé par l’application | VT_BSTR | |
| g_wszWMDMDeviceModelName | Nom du modèle d’appareil | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Version du microprogramme | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Extension de fournisseur prise en charge par l’appareil | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protocole utilisé pour la communication entre l’hôte et l’appareil | VT_CLSID | Les valeurs prédéfinies sont :WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | ID du fournisseur fournissant un fournisseur de services Windows Media Device Manager pour l’appareil | VT_CLSID | Les valeurs prédéfinies sont :WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Réservé pour une utilisation ultérieure. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Informations de révocation pour un appareil. Ces informations incluent des éléments tels que l’URL de révocation. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Tableau de noms de propriétés pour les propriétés prises en charge par l’appareil | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nom convivial de l’appareil | VT_BSTR |
Constantes de métadonnées des appareils portables Windows
| Propriété Appareils portables Windows | Description | TYPE PROPVARIANT(vt) | Commentaires |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Objet volumineux binaire (ou BLOB) utilisé pour définir ou récupérer les propriétés des appareils portables Windows | WMDM_TYPE_BINARY | Permet aux clients Windows Media Device Manager de lire et d’écrire des propriétés d’appareil portable Windows introuvables dans Windows Media Device Manager. Notez que certaines propriétés d’appareil portable Windows peuvent ne pas être accessibles. |