Constantes de metadados
Metadados são informações descritivas sobre o conteúdo transferido de ou para um dispositivo. No Windows Media Gerenciador de Dispositivos, 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 Windows Media Gerenciador de Dispositivos tem propriedades comuns predefinidas e é altamente recomendável usá-las, definindo as 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 seguintes constantes de propriedade de metadados foram definidas para uso neste SDK. Eles são definidos em mswmdm.h.
Constantes de metadados de armazenamento
| Propriedade storage | Descrição | Tipo de Gerenciador 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 dá suporte ou não à arte do álbum | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMAlbumArtist | Artistas do Álbum da Faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAlbumCoverData | Blob de bytes JPEG de arte do álbum | WMDM_TYPE_BINARY | BYTE* |
| g_wszWMDMAlbumCoverDuration | Duração da capa do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverFormat | Formato de arte do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverHeight | Altura da arte do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverSize | Tamanho da arte do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumCoverWidth | Largura da arte do álbum | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMAlbumTitle | Título do álbum da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAudioBitDepth | Profundidade do bit de áudio | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDBackReferences | Uma referência ao objeto de contêiner. Por exemplo, um objeto de áudio usaria essa propriedade para fazer referência a uma playlist. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMAuthor | Autor de 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 há suporte para CBR e um conjunto discreto de taxas de bits. MTP_BITRATETYPE_VARIABLE (0x0002) que indica suporte para VBR. MTP_BITRATE_TYPE_FREE (0x0003) que indica que os valores cbr e taxa de bits são contínuos em um intervalo especificado. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBlockAlignment | Alinhamento de bloco | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Tamanho do buffer | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Compre este álbum (necessário para a arte do álbum) | WMDM_TYPE_BOOL | BOOL |
| g_wszWMDMByteBookmark | Um indicador que identifica a última posição reproduzida ou exibida em um objeto de mídia. (Este indicador é um deslocamento de bytes 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 de música | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDataLength | O comprimento dos dados do 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 o comprimento dos dados (g_wszWMDMDataLength) e as propriedades de unidades de dados (g_wszWMDMDataUnits). As unidades serão consideradas bytes se essa propriedade não estiver definida. |
WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMDescription | Descrição de série de TV ou foto | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMDestinationURL | A URL associada a um objeto . Essa propriedade normalmente é usada para um objeto de conversã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 email 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 compatíveis com um dispositivo | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileAttributes | Os atributos de um objeto de arquivo | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMediaClassPrimaryID | Música, vídeo, áudio sem música, outros | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileCreationDate | Data de criação do arquivo | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMFileName | Nome do arquivo. Equivalente a chamar IWMDMStorage::GetName. | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMFileSize | Tamanho do arquivo, 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 | True se não for 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 | Livros de áudio, vídeos de música, rádio de conversa e assim por diante | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaCredits | Créditos de TV (atores, diretores, 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 do qual o episódio foi gravado | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMediaStationName | Cartas de chamada ou nome da estação de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo de conteúdo derivado da ID da classe secundária primária & | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMNonConsumable | Se o conteúdo é armazenado como um blob de dados opaco no dispositivo. Nesse caso, 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 indicador (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 para o proprietário de um objeto de mídia | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMParentalRating | Classificação de consultoria | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPersistentUniqueID | ID exclusiva gerada pelo dispositivo para armazenamento | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMPlayCount | Contagem total de reprodução de arquivo | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMProviderCopyright | Nome do detentor de direitos autorais | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMQualitySetting | Configuração de qualidade | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMSampleRate | Taxa de amostragem | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMScanType | Tipo de exame | 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 indicador (em milissegundos) que especifica a última posição reproduzida ou exibida | 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 total de bits | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrack | Número da faixa (1 99) | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMTrackMood | Humor da faixa | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMUserEffectiveRating | Calculado com base no usuário, nas classificações de serviço e na contagem de reprodução | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserLastPlayTime | Carimbo de data/hora de última escuta ou visualização | WMDM_TYPE_DATE | WMDMDATETIME |
| g_wszWMDMUserRating | Classificação do conjunto de usuários | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMUserRatingOnDevice | Classificação do conjunto de usuários 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 email 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 em que o álbum foi lançado | WMDM_TYPE_STRING | LPCWSTR |
Constantes de metadados do dispositivo
| Propriedade de dispositivo | Descrição | Tipo PROPVARIANT(vt) | Comentários |
|---|---|---|---|
| g_wszWMDMSupportedDeviceProperties | Matriz de nomes de propriedades para propriedades compatíveis com o 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 compatíveis com o dispositivo | VT_UI4 | VT_ARRAY | |
| g_wszWMDMFormatsSupportedAreOrdered | Indica se o formato retornado na matriz de formatos com suporte é 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 relação de sincronização usada 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 compatível com o 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 provedor de serviços do Windows Media Gerenciador de Dispositivos 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 incluem elementos como a URL de revogação. |
VT_BSTR | |
| g_wszWMDMSupportedDeviceProperties | Matriz de nomes de propriedades para propriedades compatíveis com o 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) | Comentários |
|---|---|---|---|
| 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 Windows Media Gerenciador de Dispositivos leiam e escrevam propriedades do Dispositivo Portátil do Windows que não são encontradas no Windows Media Gerenciador de Dispositivos. Observe que algumas propriedades do Dispositivo Portátil do Windows podem não estar acessíveis. |