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 prédéfini des propriétés courantes et il est vivement recommandé d’utiliser ceux qui définissent les nouveaux. 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 une utilisation dans ce Kit de développement logiciel (SDK). Celles-ci sont définies dans mswmdm.h.
constantes de métadonnées Stockage
| Stockage propriété | Description | Windows type de Gestionnaire de périphériques 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 l’art de l’album | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistes de l’album de track | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Objet blob d’octets JPEG d’album | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Durée de la couverture de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Format d’art de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Hauteur d’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’art de l’album | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Titre de l’album du 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 de 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 | buffer_size | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Acheter cet album (obligatoire pour l’art 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 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 la 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 de 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 du cadre clé | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | Le fichier date/heure a été modifié pour la dernière fois. Équivalent à l’appel d’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 l’é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 secondaire primaire & | 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 rendre. | 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 qui a été 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 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 lors de la copie | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Signet (en millisecondes) qui spécifie la dernière position jouée ou affichée | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Heure (en minutes) jusqu’à ce que le contenu soit mis à jour | 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 de la piste | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculé à partir de l’utilisateur, des évaluations de service et du nombre de lecture | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Dernière écoute ou horodatage | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Évaluation de l’ensemble de l’utilisateur | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Évaluation de l’ensemble de l’utilisateur modifiée sur l’appareil | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Taux de bits 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 où l’album a été publié | 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 de formats pris en charge est ordonné en fonction de 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 media Gestionnaire de périphériques Windows 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 |
Windows constantes de métadonnées d’appareils portables
| propriété Windows Portable Devices | Description | TYPE PROPVARIANT(vt) | Commentaires |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Objet volumineux binaire (ou BLOB) utilisé pour définir ou récupérer Windows propriétés d’appareils portables | WMDM_TYPE_BINARY | Permet aux clients Windows Media Gestionnaire de périphériques de lire et d’écrire Windows propriétés d’appareil portable introuvables dans Windows Gestionnaire de périphériques Multimédia. Notez que certaines propriétés de l’appareil portable Windows peuvent ne pas être accessibles. |