Share via

Extensiones de dispositivo para informes de contenido adquirido

  • Artículo

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Reproductor multimedia de Windows 11 presenta una nueva funcionalidad que permite a los dispositivos portátiles notificar al Reproductor el contenido agregado al dispositivo desde la última sincronización. Reproductor multimedia de Windows 11 puede usar esta información para copiar contenido recién adquirido del dispositivo al equipo del usuario. Los fabricantes de dispositivos deben tener en cuenta los siguientes requisitos para admitir esta funcionalidad:

  • Esta característica solo se admite para dispositivos habilitados para MTP.
  • Esta característica solo funciona con dispositivos que tienen una asociación con Reproductor multimedia de Windows.
  • Los dispositivos solo deben notificar el contenido que el dispositivo creó o descargó. Esto incluye fotos tomadas por el dispositivo; grabaciones de voz creadas por el dispositivo; grabaciones de correo de voz; descargas de una tarjeta de almacenamiento; y se descarga desde Internet. El contenido almacenado en el dispositivo como resultado de la sincronización con otro dispositivo o una asociación diferente no se debe notificar.

El archivo de encabezado denominado wmpdevices.h, que se instala como parte del SDK de Reproductor multimedia de Windows, define las estructuras y constantes necesarias para admitir Reproductor multimedia de Windows extensiones de dispositivo.

Para que un dispositivo se reconozca como compatible con los informes de contenido adquirido a través del conjunto de extensiones de dispositivo MTP de Reproductor multimedia de Windows, debe incluir la siguiente información en el conjunto de datos DeviceInfo. (Para obtener más información sobre este conjunto de datos, consulte la sección 4.6.1 de la especificación MTP).

Campo conjunto de datos Orden de campo Tipo de datos Value
VendorExtensionID 2 UINT32 0x00000006
VendorExtensionVersion 3 UINT16 0x0064 (100)
VendorExtensionDesc 4 String "microsoft.com/WMPPD: 11.0"

 

En la tabla siguiente se proporcionan detalles sobre la operación MTP para informar del contenido adquirido.

Elemento Descripción
Código de operación 0x9202
Parámetro de operación 1 Identificador de transacción proporcionado por el dispositivo durante la sesión anterior. Este valor es cero para la primera sesión.
Parámetro de operación 2 Índice inicial. Este valor siempre es cero en la primera llamada de una sesión. En las llamadas posteriores dentro de la misma sesión de sincronización, este valor aumenta por el recuento de los elementos devueltos por los datos de respuesta anteriores.
Parámetro de operación 3 0x10000. Esta constante, definida en wmpdevices.h, es el número máximo de PUOID que se pueden devolver en la respuesta. Tenga en cuenta que el valor de esta constante se puede revisar en futuras versiones de este archivo de encabezado.
Parámetro de operación 4 0
Parámetro de operación 5 0
data El dispositivo devuelve una matriz MTP que contiene PUOID que se han adquirido. La matriz comienza con un valor DWORD que indica el recuento de elementos de la matriz, seguido de la matriz de elementos.
Dirección de datos R-I>
Opciones de código de respuesta MTP_RESPONSE_OK (0x2001) o código de respuesta de error válido.
Parámetro de respuesta 1 Identificador de transacción actual.
Parámetro de respuesta 2 Número de PUOID que siguen siendo recuperados por solicitudes futuras.
Parámetro de respuesta 3 DWORD que contiene información de estado. El estado se indica de forma bit a bit. Vea Comentarios para obtener información sobre las marcas que se van a usar.
Parámetro de respuesta 4 0
Parámetro de respuesta 5 0

 

Observaciones

El estado se indica a través del parámetro de respuesta 3 de forma bit a bit mediante la marca siguiente.

Marca Value Descripción
WMP_MDRT_FLAGS_UNREPORTED_ACQUIRED_ITEMS 0x1 El dispositivo contiene algunos elementos adquiridos que no se pueden devolver en la lista de PUOIDS. Tenga en cuenta que esta marca no es redundante con el parámetro de respuesta 2. Establezca esta marca solo cuando haya elementos solicitados que el dispositivo no pueda devolver.

 

Los bits de 1 a 31 están reservados para uso futuro. Estos bits deben establecerse en cero.

Reproductor de Windows Media