Constantes de metadatos
Los metadatos son información descriptiva sobre el contenido transferido a un dispositivo o desde él. En windows Media Administrador de dispositivos, 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 que se describen en la enumeración WMDM_TAG_DATATYPE .
Windows Media Administrador de dispositivos tiene propiedades comunes predefinidas y se recomienda encarecidamente usarlas en lugar de definir 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 | Si el dispositivo admite o no la imagen del álbum | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistas del álbum de canciones | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Blob de bytes JPEG de arte de á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 de la imagen 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 de 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 la 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 | 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 del medio, 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 que no es de música, 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 de 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 imagen o vídeo | 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 | Audiolibros, 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 se emitió por primera vez | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Canal desde el que se grabó ese episodio | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Letras o nombre de la estación de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo de contenido derivado del identificador de clase secundario 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 recorrido | 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 de bits total | 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 | Se ha cambiado la clasificación del conjunto de usuarios 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 de dispositivo | 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 las preferencias 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 | Identificador de relación de sincronización usado por la aplicación | VT_BSTR | |
| g_wszWMDMDeviceModelName | Nombre del modelo de dispositivo | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Firmware version | 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 Administrador de dispositivos 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 de Windows Media Administrador de dispositivos leer y escribir propiedades del dispositivo portátil de Windows que no se encuentran en Windows Media Administrador de dispositivos. Tenga en cuenta que es posible que algunas propiedades del dispositivo portátil de Windows no sean accesibles. |