Método Media.getItemInfo

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método getItemInfo recupera o valor do atributo especificado para o item de mídia atual.

Sintaxe

strRetVal = Media.getItemInfo(
  name
)

Parâmetros

name [in]

Cadeia de caracteres que contém o nome do atributo. Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de Atributo Reprodutor Multimídia do Windows.

Retornar valor

Esse método retorna um String que representa o valor do atributo especificado. Para atributos cujo valor subjacente é booliano, ele retorna a cadeia de caracteres "true" ou "false".

Comentários

Esse método recupera os metadados de um item de mídia digital individual ou um item de mídia que faz parte de uma playlist.

A propriedade attributeCount contém o número de nomes de atributo disponíveis para um determinado objeto Media . Os números de índice podem ser usados com o método getAttributeName para determinar o nome de cada atributo disponível. Nomes de atributos individuais podem ser passados para getItemInfo.

Para recuperar atributos com vários valores e atributos com valores complexos, use o método getItemInfoByType .

Para usar esse método, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Para compartilhar as bibliotecas de mídia do Windows por UPnP, Reprodutor Multimídia do Windows cria um CDS (serviço de diretório de conteúdo) exposto por UPnP. Outros dispositivos podem navegar e navegar pelas bibliotecas.

No Windows 7, um aplicativo pode usar os atributos Reprodutor Multimídia do Windows TrackingID e MediaType para construir a ID de objeto de cada item no CDS. Observe que essa construção pode mudar em versões futuras do Windows. O aplicativo passa cada uma dessas cadeias de caracteres de atributo no parâmetro name em uma chamada para getItemInfo. getItemInfo retorna o valor de cada atributo no valor retornado. Em seguida, o aplicativo usa a seguinte sintaxe para construir cada ID de objeto:

TrackingID.0. MediaTypeID

Essa sintaxe tem o seguinte significado:

• TrackingID é a cadeia de caracteres armazenada no atributo Reprodutor Multimídia do Windows TrackingID do item de mídia.

• MediaTypeID depende do valor do atributo MediaType , conforme mostrado na tabela a seguir:

  Atributo MediaType	MediaTypeID
  Itens de Áudio	4
  Itens de foto	B
  Itens de Vídeo	8

Reprodutor Multimídia do Windows 10 Mobile: os atributos de um item de mídia só estão disponíveis durante a reprodução, a menos que sejam recuperados do item por meio da coleção de mídia.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Media

Media.attributeCount

Media.getAttributeName

Media.getItemInfoByType

Media.setItemInfo

Valores de atributo de leitura

Settings.mediaAccessRights

Settings.requestMediaAccessRights