Requisitos para que los reproductores de audio portátiles aparezcan en el Explorador de Windows
La extensión de espacio de nombres del shell del reproductor de audio portátil proporciona a los usuarios de Windows una manera coherente de administrar dispositivos de audio administrados por Windows Media Administrador de dispositivos. Si crea los componentes del proveedor de servicios y del controlador según las directrices siguientes, el dispositivo se mostrará en el espacio de nombres del shell. Los usuarios podrán interactuar con el contenido del dispositivo de forma coherente en el Explorador de Windows para realizar operaciones básicas como copiar, eliminar y cambiar el nombre.
Los siguientes requisitos de shell para los componentes de proveedor de servicios y controladores están diseñados para complementar las directrices generales de Windows Media Administrador de dispositivos.
Capacidades del dispositivo
Los proveedores de servicios de Windows Media Administrador de dispositivos deben ser explícitos en sus funcionalidades admitidas. Si no se admite una llamada, se debe devolver un código de error. Los campos adecuados deben establecerse para la presencia o ausencia de funcionalidades devueltas por las siguientes funciones:
Los proveedores de servicios deben admitir las siguientes funcionalidades para que sean compatibles con el shell:
- Copiar en el dispositivo (con compatibilidad con devoluciones de llamada de cancelación y progreso)
- Eliminar archivo del dispositivo (con compatibilidad con devoluciones de llamada de cancelación y progreso)
- Cambiar el nombre del archivo en el dispositivo
- Informes de espacio (espacio total, espacio libre, espacio inutilizable)
- Plug and Play (consulte Habilitación de PnP para dispositivos)
- Formato (preferiblemente con compatibilidad con devoluciones de llamada de cancelación y progreso)
Si se admiten metadatos, se deben admitir los siguientes campos para archivos individuales. Si no hay datos disponibles, el campo se debe inicializar como una cadena vacía:
Campo | Constante (definida en WMDM.idl) | Etiqueta de metadatos |
---|---|---|
Título de la canción | g_wszWMDMTitle | WMDM/Title |
Número de pista | g_wszWMDMTrack | WMDM/Track |
Artista | g_wszWMDMAuthor | WMDM/Author |
Álbum | g_wszWMDMAlbumTitle | WMDM/AlbumTitle |
Year | g_wszWMDMYear | WMDM/Año |
Género | g_wszWMDMGenre | WMDM/Género |
Simultaneidad
Los controladores de modo kernel para Windows Media Administrador de dispositivos deben ser sólidos para controlar el acceso simultáneo. Por ejemplo, un usuario puede acceder simultáneamente al dispositivo a través del shell y el reproductor multimedia o simplemente a través de varias ventanas del shell. Como parte del control de la simultaneidad, los controladores no deben suponer, solo porque se carga el proveedor de servicios, que el dispositivo está en uso. En su lugar, deben implementar un mecanismo de bloqueo para serializar el acceso al dispositivo según sea necesario para las operaciones individuales.
UI
Los proveedores de servicios para Windows Media Administrador de dispositivos no deben mostrar ninguna interfaz de usuario. Los errores deben devolverse desde llamadas de método como windows Media específicos Administrador de dispositivos códigos de error siempre que sea posible.
Habilitación en el shell
Si el paquete cumple todos los requisitos del shell, puede permitir que el dispositivo se muestre en el shell estableciendo el valor de ShowInShell en 1 en los parámetros del dispositivo. Para obtener más información, consulte Parámetros del dispositivo.
Temas relacionados