Constantes de metadados
Metadados são informações descritivas sobre o conteúdo transferido de ou para um dispositivo. No Gerenciador de Dispositivos de Mídia do Windows, 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 Gerenciador de Dispositivos de Mídia do Windows tem propriedades comuns predefinidas e é altamente recomendável que você as use, 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. Elas são definidas em mswmdm.h.
Constantes de metadados de armazenamento
| Propriedade de armazenamento | Descrição | Tipo do Gerenciador de Dispositivos de Mídia do Windows | 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 o CBR e um conjunto discreto de taxas de bits têm suporte. 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 blocos | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBufferSize | Tamanho do buffer | WMDM_TYPE_DWORD | DWORD |
| g_wszWMDMBuyNow | Comprar 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 | Série de TV ou descrição da 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 ns unidades | WMDM_TYPE_QWORD | QWORD |
| g_wszWMDMEditor | O endereço de email do editor-gerente associado a um objeto de mídia. Essa propriedade normalmente é usada para identificar o editor-gerente 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 o 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 musicais, 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 | Nome ou letras de chamada da estação de TV | WMDM_TYPE_STRING | LPCWSTR |
| g_wszWMDMMetaGenre | Tipo de conteúdo derivado da ID da classe primária & secundá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 do 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 titular dos 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 verificaçã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 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 | Último carimbo de data/hora escutado ou exibido | 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 de vídeo ou 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 do 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 VERDADEIRO, 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 de dispositivo | VT_BSTR | |
| g_wszWMDMDeviceFirmwareVersion | Versão do firmware | VT_UI4 | |
| g_wszWMDMDeviceVendorExtension | Extensão do fornecedor com suporte por 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 Gerenciador de Dispositivos de Mídia do Windows 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 Gerenciador de Dispositivos de Mídia do Windows leiam e escrevam propriedades do Dispositivo Portátil do Windows que não são encontradas no Gerenciador de Dispositivos de Mídia do Windows. Observe que algumas propriedades do Dispositivo Portátil do Windows podem não estar acessíveis. |