Partilhar via


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.

de referência de programação