Constantes de metadados
Os metadados são informações descritivas sobre o conteúdo transferido de ou para um dispositivo. No Gestor de Dispositivos do Windows Media, os metadados consistem em propriedades, em que cada propriedade é um par nome-valor. O nome é sempre uma cadeia de caracteres largos. O valor é um dos vários tipos de dados definidos descritos na enumeração WMDM_TAG_DATATYPE.
O Gestor de Dispositivos do Windows Media tem propriedades comuns predefinidas e é altamente recomendável que as utilize em vez de definir novas. Para cada propriedade predefinida, o SDK define uma constante global que contém a cadeia de caracteres de nome. Você pode reduzir a chance de erros tipográficos usando a constante global. Por exemplo, a constante g_wszWMDMTitle é definida como "Title", correspondente à propriedade Title.
As constantes de propriedade de metadados a seguir foram definidas para uso neste SDK. Estes são definidos em mswmdm.h.
Constantes de metadados de armazenamento
| Propriedade de armazenamento | Descrição | Tipo de Gestor de Dispositivos do Windows Media | Tipo subjacente |
|---|---|---|---|
| g_wszAudioWAVECodec | Codec de áudio | WMDM_TYPE_DWORD | DWORD |
| g_wszVideoFourCCCodec | Codec de vídeo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumArt | Se o dispositivo suporta ou não capas de álbuns | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistas do álbum da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Capa do álbum JPEG byte blob | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Duração da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Formato da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Altura da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Tamanho da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Largura da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Título do álbum da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profundidade de bits de áudio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Uma referência ao objeto container. Por exemplo, um objeto audio usaria essa propriedade para fazer referência a uma lista de reprodução. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Autor do conteúdo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthorDate | Data de criação do conteúdo | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMBitrate | Taxa de bits de áudio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBitrateType | O tipo de taxa de bits MTP. (Atualmente não implementado.)Os valores válidos são: MTP_BITRATETYPE_DISCRETE (0x001) que indica que CBR e um conjunto discreto de taxas de bits são suportados. MTP_BITRATETYPE_VARIABLE (0x0002) que indica suporte para VBR. MTP_BITRATE_TYPE_FREE (0x0003) que indica que os valores de CBR e taxa de bits são contínuos em um intervalo especificado. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Alinhamento de blocos | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Tamanho do buffer | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Compre este álbum (necessário para a capa do álbum) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | Um marcador que identifica a última posição tocada ou visualizada em um objeto de mídia. (Este marcador é um deslocamento de byte baseado em zero.) | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMCategory | Um campo de texto que indica o gênero de um item de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMCodec | Reservado para uso futuro | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMComposer | Compositor musical | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | O comprimento dos dados para o objeto referenciado | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataOffset | Um deslocamento baseado em zero para o objeto referenciado | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMDataUnits | As unidades usadas para as propriedades de comprimento de dados (g_wszWMDMDataLength) e unidades de dados (g_wszWMDMDataUnits). As unidades são consideradas bytes se essa propriedade não estiver definida. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Série de TV ou descrição de fotos | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | A URL associada a um objeto. Essa propriedade é normalmente usada para um objeto de transmissão de mídia (ou relacionado). |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMRMId | Reservado para uso futuro | ||
| g_wszWMDMDevicePlayCount | Contagem de reprodução no dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDuration | Duração da mídia, em 100 unidades ns | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | O endereço de e-mail do editor de gerenciamento associado a um objeto de mídia. Essa propriedade é normalmente usada para identificar o editor de gerenciamento de um canal RSS. |
WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMEncodingProfile | Os perfis de codificação WMV9 suportados por um dispositivo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Os atributos para um objeto de arquivo | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Música, vídeo, áudio não musical, outros | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Data de criação do ficheiro | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nome do arquivo. Equivalente a chamar IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Tamanho do ficheiro, em bytes. Equivalente a chamar IWMDMStorage::GetSize. | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMFormatCode | Formatar código para formato de conteúdo. Deve ser um valor WMDM_FORMATCODE. |
WMDM_TYPE_DWORD | WMDM_FORMATCODE |
| g_wszWMDMFrameRate | Taxa de quadros | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMGenre | Gênero da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMHeight | Altura do vídeo ou da imagem | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMIsProtected | Se o conteúdo é protegido por DRM | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMIsRepeat | Verdade, se não a primeira vez que o episódio foi ao ar | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMKeyFrameDistance | Distância do quadro-chave | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMLastModifiedDate | O arquivo de data/hora foi modificado pela última vez. Equivalente a chamar IWMDMStorage::GetDate. | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaClassSecondaryID | Audiolivros, videoclipes, rádio e assim por diante | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Créditos televisivos (atores, realizador, produtores) | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaGuid | Identificador global exclusivo para o conteúdo de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaOriginalBroadcastDateTime | Data em que o episódio foi ao ar pela primeira vez | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMMediaOriginalChannel | Canal esse episódio foi gravado a partir de | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Letras ou nome de chamada da estação de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo de conteúdo derivado do ID de classe primário & secundário | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Se o conteúdo é armazenado como um blob de dados opaco no dispositivo. Em caso afirmativo, o dispositivo não precisa entender o formato ou renderizá-lo. | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMNumChannels | Número de canais | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMObjectBookmark | Um marcador (em milissegundos) que especifica a última posição no objeto de mídia que foi reproduzido ou exibido | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMOwner | O endereço de email do proprietário de um objeto de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Avaliação consultiva | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | ID exclusivo gerado pelo dispositivo para armazenamento | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Contagem total de reprodução de ficheiros | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Nome do titular dos direitos de autor | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Definição de qualidade | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Taxa de amostragem | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Tipo de digitalização | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSourceURL | A URL de origem de um objeto de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitle | Título do episódio de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSubTitleDescription | Descrição do episódio de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncID | GUID gerado pelo aplicativo para fins de sincronização | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMSyncTime | Carimbo de data/hora do dispositivo quando copiado | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMTimeBookmark | Um marcador (em milissegundos) que especifica a última posição jogada ou visualizada | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTimeToLive | O tempo (em minutos) até que o conteúdo seja atualizado | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMTitle | Título da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMTotalBitrate | Taxa de bits total | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Número da faixa (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Humor da pista | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculado a partir do utilizador, classificações de serviço e contagem de jogos | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Carimbo de data/hora ouvido ou visualizado pela última vez | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Classificação definida pelo utilizador | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Classificação definida pelo usuário alterada no dispositivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMVideoBitrate | Taxa de bits de vídeo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMWebmaster | O endereço de e-mail do webmaster responsável por um objeto de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMWidth | Largura do vídeo ou da imagem | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMYear | Ano de lançamento do álbum | WMDM_TYPE_STRING | LPCWSTR |
Constantes de metadados do dispositivo
| Propriedade do dispositivo | Descrição | Tipo PROPVARIANT (vt) | Observações |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Matriz de nomes de propriedade para propriedades suportadas pelo dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nome amigável do dispositivo | VT_BSTR | |
| g_wszWMDMFormatsSupported | Matriz de códigos de formato para os formatos suportados pelo dispositivo | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Indica se o formato retornado na matriz de formatos suportados é ordenado de acordo com a preferência do dispositivo. Se essa propriedade estiver definida como TRUE, os aplicativos deverão transferir conteúdo usando os códigos de formato que aparecem primeiro na matriz. |
VT_BOOL | |
| g_wszWMDMSyncRelationshipID | ID de relacionamento de sincronização usado pelo aplicativo | VT_BSTR | |
| g_wszWMDMDeviceModelName | Nome do modelo do dispositivo | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Versão do firmware | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Extensão de fornecedor suportada pelo dispositivo | VT_BSTR | |
| g_wszWMDMDeviceProtocol | Protocolo usado para comunicação entre o host e o dispositivo | VT_CLSID | Os valores predefinidos são:WMDM_DEVICE_PROTOCOL_MTP, WMDM_DEVICE_PROTOCOL_RAPI, WMDM_DEVICE_PROTOCOL_MSC |
| g_wszWMDMDeviceServiceProviderVendor | ID do fornecedor que fornece um fornecedor de serviços do Gestor de Dispositivos Windows Media para o dispositivo | VT_CLSID | Os valores predefinidos são:WMDM_SERVICE_PROVIDER_VENDOR_MICROSOFT |
| g_wszWMDMCollectionID | Reservado para uso futuro. | VT_BSTR | |
| g_wszWMDMDeviceRevocationInfo | As informações de revogação de um dispositivo. Essas informações incluiriam elementos como a URL de revogação. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Matriz de nomes de propriedade para propriedades suportadas pelo dispositivo | VT_BSTR | VT_ARRAY | |
| g_wszWMDMDeviceFriendlyName | Nome amigável do dispositivo | VT_BSTR |
Constantes de metadados de dispositivos portáteis do Windows
| Propriedade Dispositivos Portáteis do Windows | Descrição | Tipo PROPVARIANT (vt) | Observações |
|---|---|---|---|
| g_wszWPDPassthroughPropertyValues | Um objeto binário grande (ou BLOB) usado para definir ou recuperar propriedades de Dispositivos Portáteis do Windows | WMDM_TYPE_BINARY | Permite que os clientes do Gestor de Dispositivos Windows Media leiam e gravem propriedades do Dispositivo Portátil do Windows que não se encontram no Gestor de Dispositivos do Windows Media.Tenha em atenção que algumas propriedades do Dispositivo Portátil do Windows poderão não estar acessíveis. |