Constantes de métadonnées
Les métadonnées sont des informations descriptives sur le contenu transféré vers ou à partir d’un appareil. Dans Windows Media Gestionnaire de périphériques, 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 Gestionnaire de périphériques a des propriétés courantes prédéfinies et il est vivement recommandé d’utiliser celles-ci au lieu de définir de nouvelles. Pour chaque propriété prédéfinie, le Kit de développement logiciel (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 SDK. Elles 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 ou non en charge l’illustration d’album | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistes de l’album track’s | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Objet blob d’octets JPEG de l’art de l’album | WMDM_TYPE_BINARY | OCTET* |
| g_wszWMDMAlbumCoverDuration | Durée de la couverture de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Format d’illustration de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Hauteur de l’illustration de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Taille de l’illustration de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Largeur de l’illustration de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Titre de l’album de la piste | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profondeur de bits 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 débits binaires 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 le débit binaire sont continus sur une plage spécifiée. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Alignement des blocs | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | buffer_size | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Acheter cet album (obligatoire pour l’illustration de 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 | Paramètres réservés pour un usage ultérieur | 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 par rapport à l’objet référencé | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Unités utilisées pour les propriétés longueur des données (g_wszWMDMDataLength) et 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 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 | Paramètres réservés pour un usage ultérieur | ||
| 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 musical, autres | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Date de création du fichier | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nom du 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 | Mettre en forme le 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 | 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 l’image clé | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Le fichier de 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, radio de conversation, 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é pour la première fois | 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 secondaire principal & | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Indique si le contenu est stocké sous la forme d’un objet blob de données opaque sur l’appareil. Si c’est le 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 du propriétaire d’un objet multimédia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Évaluation de l’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 | É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 en cas de 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 | Temps (en minutes) jusqu’à la mise à jour du contenu | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Titre du suivi | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Débit binaire total | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Numéro de suivi (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Humeur du track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculé à partir des utilisateurs, des évaluations de service et du nombre de jeux | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Horodatage de la dernière écoute ou vue | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Évaluation de l’ensemble des utilisateurs | 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 | Débit binaire vidéo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | Adresse e-mail du webmestre 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é d’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 des formats pris en charge est classé en fonction de la préférence de l’appareil. Si cette propriété a la valeur TRUE, les applications doivent transférer le 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 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 Gestionnaire de périphériques pour l’appareil | VT_CLSID | Les valeurs prédéfinies sont :WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Réservé pour un usage futur. | 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 | Un objet binaire volumineux (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 Gestionnaire de périphériques de lire et d’écrire des propriétés d’appareil portable Windows introuvables dans Windows Media Gestionnaire de périphériques. Notez que certaines propriétés d’appareil portable Windows peuvent ne pas être accessibles. |