Constantes de metadatos
Los metadatos son información descriptiva sobre el contenido transferido a un dispositivo o desde él. En el Administrador de dispositivos de Windows Media, los metadatos constan de propiedades, donde cada propiedad es un par nombre-valor. El nombre siempre es una cadena de caracteres anchos. El valor es uno de varios tipos de datos definidos descritos en la enumeración WMDM_TAG_DATATYPE.
El Administrador de dispositivos de Windows Media tiene propiedades comunes predefinidas y se recomienda encarecidamente usarlas en su lugar definiendo otras nuevas. Para cada propiedad predefinida, el SDK define una constante global que contiene la cadena de nombre. Puede reducir la posibilidad de errores tipográficos mediante la constante global. Por ejemplo, la constante g_wszWMDMTitle se define como "Title", correspondiente a la propiedad Title.
Se han definido las siguientes constantes de propiedad de metadatos para su uso en este SDK. Se definen en mswmdm.h.
Constantes de metadatos de almacenamiento
| Propiedad Storage | Descripción | Tipo de Administrador de dispositivos de Windows Media | tipo subyacente |
|---|---|---|---|
| g_wszAudioWAVECodec | Códec de audio | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Códec de vídeo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Indica si el dispositivo admite o no el arte del álbum | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistas del álbum de la pista | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Blob de bytes JPEG de arte del álbum | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Duración de la portada del álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Formato de arte del álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Altura del arte del álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Tamaño de la imagen del álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Ancho del arte del álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Título del álbum de la pista | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profundidad de bits de audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Referencia al objeto contenedor. Por ejemplo, un objeto de audio usaría esta propiedad para hacer referencia a una lista de reproducción. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Autor del contenido | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Fecha de creación del contenido | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMBitrate | Velocidad de bits de audio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | Tipo de velocidad de bits MTP. (Actualmente no está implementado).Los valores válidos son: MTP_BITRATETYPE_DISCRETE (0x001) que indica que se admiten CBR y un conjunto discreto de velocidades de bits. MTP_BITRATETYPE_VARIABLE (0x0002) que indica la compatibilidad con VBR. MTP_BITRATE_TYPE_FREE (0x0003) que indica que los valores de CBR y velocidad de bits son continuos en un intervalo especificado. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Alineación de bloques | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Tamaño del búfer | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Comprar este álbum (necesario para el arte del álbum) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | Marcador que identifica la última posición reproducida o vista en un objeto multimedia. (Este marcador es un desplazamiento de bytes de base cero). | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Campo de texto que indica el género de un elemento multimedia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Reservado para uso futuro | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Compositor de música | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | Longitud de datos del objeto al que se hace referencia | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Desplazamiento de base cero al objeto al que se hace referencia | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | Las unidades usadas para la longitud de datos (g_wszWMDMDataLength) y las propiedades de las unidades de datos (g_wszWMDMDataUnits). Se supone que las unidades son bytes si esta propiedad no está establecida. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Serie de TV o descripción de fotos | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | Dirección URL asociada a un objeto . Esta propiedad se usa normalmente para un objeto de conversión multimedia (o relacionado). |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Reservado para uso futuro | ||
| g_wszWMDMDevicePlayCount | Recuento de reproducción en el dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Duración media, en 100 ns unidades | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | Dirección de correo electrónico del editor de administración asociado a un objeto multimedia. Esta propiedad se usa normalmente para identificar el editor de administración de un canal RSS. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | Los perfiles de codificación WMV9 compatibles con un dispositivo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Atributos de un objeto de archivo | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Música, vídeo, audio no musical, otros | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Fecha de creación del archivo | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nombre de archivo. Equivalente a llamar a IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Tamaño del archivo, en bytes. Equivalente a llamar a IWMDMStorage::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Formato de código para el formato de contenido. Debe ser un valor WMDM_FORMATCODE. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Velocidad de fotogramas | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Género de pistas | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Alto de vídeo o imagen | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Si el contenido está protegido con DRM | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMIsRepeat | True si no es la primera vez que se ha transmitido el episodio | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMKeyFrameDistance | Distancia de fotograma clave | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | El archivo de fecha y hora se modificó por última vez. Equivalente a llamar a IWMDMStorage::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Libros de audio, vídeos musicales, hablar radio, etc. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Créditos de TELEVISIÓN (actores, directores, productores) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Identificador único global del contenido multimedia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Fecha en que ese episodio fue transmitido por primera vez | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Canal desde el que se grabó ese episodio | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | La estación de TV llama a letras o nombre | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo de contenido derivado del identificador de clase secundario de & principal | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Si el contenido se almacena como un blob de datos opaco en el dispositivo. Si es así, el dispositivo no necesita comprender el formato ni representarlo. | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMNumChannels | Número de canales | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Marcador (en milisegundos) que especifica la última posición del objeto multimedia que se ha reproducido o visto | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | Dirección de correo electrónico del propietario de un objeto multimedia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Clasificación de asesoramiento | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | Identificador único generado por el dispositivo para el almacenamiento | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Recuento total de reproducción de archivos | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Nombre del titular del copyright | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Configuración de calidad | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Frecuencia de muestreo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Tipo de examen | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | Dirección URL de origen de un objeto multimedia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Título del episodio de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | Descripción del episodio de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | GUID generado por la aplicación con fines de sincronización | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Marca de tiempo del dispositivo cuando se copia | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Marcador (en milisegundos) que especifica la última posición reproducida o vista | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | Tiempo (en minutos) hasta que se actualiza el contenido. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Título de pista | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Velocidad total de bits | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Número de pista (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Estado de ánimo de la pista | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculado a partir del usuario, las clasificaciones de servicio y el recuento de juegos | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Última marca de tiempo escuchada o vista | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Clasificación del conjunto de usuarios | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Clasificación del conjunto de usuarios cambiada en el dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Velocidad de bits de vídeo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | Dirección de correo electrónico del webmaster responsable de un objeto multimedia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Ancho de vídeo o imagen | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Año en que se lanzó el álbum | WMDM_TYPE_STRING | LPCWSTR |
Constantes de metadatos de dispositivo
| Propiedad Device | Descripción | TIPO PROPVARIANT(vt) | Comentarios |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Matriz de nombres de propiedad para las propiedades admitidas por el dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nombre descriptivo del dispositivo | VT_BSTR | |
| g_wszWMDMFormatsSupported | Matriz de códigos de formato para los formatos admitidos por el dispositivo | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Indica si el formato devuelto en la matriz de formatos admitidos se ordena según la preferencia del dispositivo. Si esta propiedad se establece en TRUE, las aplicaciones deben transferir contenido mediante los códigos de formato que aparecen primero en la matriz. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | Id. de relación de sincronización usado por la aplicación | VT_BSTR | |
| g_wszWMDMDeviceModelName | Nombre del modelo de dispositivo | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Versión de firmware | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Extensión de proveedor compatible con el dispositivo | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protocolo usado para la comunicación entre el host y el dispositivo | VT_CLSID | Los valores predefinidos son:WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | Identificador del proveedor que proporciona un proveedor de servicios de Windows Media Device Manager para el dispositivo | VT_CLSID | Los valores predefinidos son:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Reservado para uso futuro. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | Información de revocación de un dispositivo. Esta información incluiría elementos como la dirección URL de revocación. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Matriz de nombres de propiedad para las propiedades admitidas por el dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nombre descriptivo del dispositivo | VT_BSTR |
Constantes de metadatos de dispositivos portátiles de Windows
| Propiedad Dispositivos portátiles de Windows | Descripción | TIPO PROPVARIANT(vt) | Comentarios |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Un objeto binario grande (o BLOB) usado para establecer o recuperar propiedades de dispositivos portátiles de Windows | WMDM_TYPE_BINARY | Permite a los clientes del Administrador de dispositivos de Windows Media leer y escribir propiedades de dispositivo portátil de Windows que no se encuentran en el Administrador de dispositivos multimedia de Windows.Tenga en cuenta que es posible que algunas propiedades del dispositivo portátil de Windows no sean accesibles. |