Share via

Extensões de dispositivo para relatórios de conteúdo adquirido

  • Artigo

[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.]

Reprodutor Multimídia do Windows 11 apresenta uma nova funcionalidade que permite que dispositivos portáteis notifiquem o Player sobre o conteúdo adicionado ao dispositivo desde a última sincronização. Reprodutor Multimídia do Windows 11 pode usar essas informações para copiar o conteúdo recém-adquirido do dispositivo para o computador do usuário. Os fabricantes de dispositivos devem observar os seguintes requisitos para dar suporte a essa funcionalidade:

  • Esse recurso tem suporte apenas para dispositivos habilitados para MTP.
  • Esse recurso funciona apenas com dispositivos que têm uma parceria com Reprodutor Multimídia do Windows.
  • Os dispositivos devem relatar apenas o conteúdo que o dispositivo criou ou baixou. Isso inclui fotos tiradas pelo dispositivo; gravações de voz criadas pelo dispositivo; gravações de caixa postal; downloads de um cartão de armazenamento e downloads da Internet. O conteúdo armazenado no dispositivo como resultado da sincronização com outro dispositivo ou de uma parceria diferente não deve ser relatado.

O arquivo de cabeçalho chamado wmpdevices.h, que é instalado como parte do SDK do Reprodutor Multimídia do Windows, define as estruturas e constantes necessárias para dar suporte a extensões de dispositivo Reprodutor Multimídia do Windows.

Para que um dispositivo seja reconhecido como compatível com o relatório de conteúdo adquirido por meio do conjunto de extensão de dispositivo mtp Reprodutor Multimídia do Windows, ele deve incluir as seguintes informações no conjunto de dados DeviceInfo. (Para obter mais informações sobre esse conjunto de dados, consulte a seção 4.6.1 da especificação mtp.)

Campo Conjunto de dados Ordem do campo Tipo de dados Valor
VendorExtensionID 2 UINT32 0x00000006
VendorExtensionVersion 3 UINT16 0x0064 (100)
VendorExtensionDesc 4 Cadeia de caracteres "microsoft.com/WMPPD: 11.0"

 

A tabela a seguir fornece detalhes sobre a operação MTP para relatar o conteúdo adquirido.

Item Descrição
Código de operação 0x9202
Parâmetro de operação 1 A ID da transação fornecida pelo dispositivo durante a sessão anterior. Esse valor é zero para a primeira sessão.
Parâmetro de operação 2 Índice inicial. Esse valor é sempre zero na primeira chamada de uma sessão. Em chamadas subsequentes na mesma sessão de sincronização, esse valor aumenta pela contagem dos itens retornados dos dados de resposta anteriores.
Parâmetro de operação 3 0x10000. Essa constante, definida em wmpdevices.h, é o número máximo de PUOIDs que podem ser retornados na resposta. Observe que o valor dessa constante pode ser revisado em versões futuras desse arquivo de cabeçalho.
Parâmetro de operação 4 0
Parâmetro de operação 5 0
Dados O dispositivo retorna uma matriz MTP que contém PUOIDs que foram adquiridos. A matriz começa com um valor DWORD que indica a contagem de itens na matriz, seguida pela matriz de elementos.
Direção de dados R-I>
Opções de código de resposta MTP_RESPONSE_OK (0x2001) ou código de resposta de erro válido.
Parâmetro de resposta 1 A ID da transação atual.
Parâmetro de resposta 2 O número de PUOIDs que permanecem a ser recuperados por solicitações futuras.
Parâmetro de resposta 3 DWORD que contém informações de status. O status é indicado de forma bit a bit. Consulte Comentários para obter informações sobre sinalizadores a serem usados.
Parâmetro de resposta 4 0
Parâmetro de resposta 5 0

 

Comentários

O status é indicado por meio do Parâmetro de Resposta 3 de forma bit a bit usando o sinalizador a seguir.

Sinalizador Valor Descrição
WMP_MDRT_FLAGS_UNREPORTED_ACQUIRED_ITEMS 0x1 O dispositivo contém alguns itens adquiridos que não podem ser retornados na lista de PUOIDS. Observe que esse sinalizador não é redundante com o Parâmetro de Resposta 2. Defina esse sinalizador somente quando houver itens solicitados que o dispositivo não possa retornar.

 

Os bits 1 a 31 são reservados para uso futuro. Esses bits devem ser definidos como zero.

Windows Media Player