Personalización de marca Panel de control con mapas de bits o iconos

En Windows XP y versiones posteriores de Windows, la aplicación de sonido de Panel de control admite la personalización de marca de terceros de controles de dispositivo de audio. Los proveedores de hardware independientes (IHD) pueden mostrar los siguientes elementos junto a los controles de sus dispositivos de audio:

• Logotipo de la compañía

• Nombre de dispositivo propietario

El archivo INF que instala el controlador de dispositivo también carga los datos de personalización Panel de control en el Registro. Las imágenes con mapa de bits de los logotipos de la empresa se incluyen en los propios archivos de controlador instalados.

En Windows XP, la información de personalización de marca es visible para los usuarios en las siguientes ubicaciones de programa:

• Página Volumen de la aplicación Sonidos y dispositivos de audio en Panel de control (Mmsys.cpl)

• El programa SndVol32 (Sndvol32.exe)

En Windows Vista, la información de personalización de marca es visible para los usuarios en las páginas Reproducción y Grabación de la aplicación Sonido en Panel de control (Mmsys.cpl).

La información de personalización de marca se almacena en el registro en una subclave Branding en la clave raíz del dispositivo de audio, que se encuentra bajo la clave de clase multimedia. La subclave Branding puede contener uno o varios de los valores de REG_SZ que se muestran en la tabla siguiente.

Nombre del valor	Significado
icon	Nombre del archivo que contiene el icono que usa el menú de control SndVol32.
bitmap	Nombre del archivo que contiene el mapa de bits de 32 a 32 que se muestra en la página Volumen de la aplicación Dispositivos de sonido y audio en Panel de control.

Estos valores se agregan al Registro mediante directivas dentro de la sección add-registry-section (consulte Inf AddReg Directive) del archivo INF que instala el controlador de dispositivo. Panel de control usa valores predeterminados para los valores que faltan en la subclave Branding.

El logotipo de "mapa de bits" aparece a la izquierda del nombre del dispositivo propietario en la parte superior de la página Volumen . El logotipo de "icono" aparece en la esquina superior izquierda del menú de control SndVol32.

El nombre del dispositivo propietario que aparece en las páginas mencionadas anteriormente es el nombre descriptivo del dispositivo. Este nombre descriptivo se especifica mediante una directiva en la sección add-registry-section del archivo INF que instala el dispositivo. Esta directiva contiene la palabra clave "FriendlyName", como se muestra en el ejemplo de directiva ADDReg inf. En Windows XP, la página Volumen y SndVol32 muestran solo los 31 primeros caracteres de la cadena de nombre. Las cadenas de mayor longitud se truncarán. En Windows Vista y versiones posteriores de Windows, esta restricción de 31 caracteres se quita cuando el nombre del dispositivo se muestra en Panel de control. Al usar las API que se admitieron en versiones de Windows anteriores a Windows Vista, por ejemplo , MCI_GetDevCaps, el límite de 31 caracteres se sigue aplicando al nombre de dispositivo que se proporciona a la API.

Importante En Windows Vista y versiones posteriores de Windows, ya no se admite el uso de imágenes de mapa de bits para la personalización de marca de terceros. Los desarrolladores de controladores de audio de terceros que quieran personalizar sus controles de dispositivo de audio deben usar iconos. Las dimensiones de píxeles admitidas para estos iconos son 32 x 32 o 48 x 48.

Ejemplo 1

En el ejemplo siguiente se muestran un par de directivas de la sección add-registry-section del archivo INF de un proveedor:

  [XYZ-Audio-Device.AddReg]
  HKR,Branding,icon,,"foo.sys,102"
  HKR,Branding,bitmap,,"c:\mydir\myimage.bmp"

Estas directivas agregan información de personalización de marca del panel de control al Registro. HKR representa la clave raíz del dispositivo de audio en el registro; la subclave Branding se especifica en relación con el nombre de ruta de acceso de la clave raíz. El valor de cadena para el icono o la clave de mapa de bits se puede especificar en uno de los dos formatos: "file,resourceid" o "imagefile". La primera directiva del ejemplo anterior usa el formato "file,resourceid". La directiva asigna a la clave de icono un valor de cadena que contiene un nombre de archivo, foo.sys y un identificador de recurso de 102. El nombre de archivo y el identificador de recurso están separados por una coma (sin espacios). El archivo foo.sys contiene el recurso de icono. La segunda directiva del ejemplo anterior asigna una cadena con formato "imagefile" a la clave de mapa de bits ; la cadena contiene el nombre de ruta de acceso completa de un archivo .bmp que contiene el mapa de bits.

La directiva de ejemplo para el valor de icono se puede cambiar para usar el formato "imagefile", pero en este caso el valor de cadena debe contener el nombre de ruta de acceso de un archivo con una extensión de nombre de archivo .ico.

En el caso del formato "file,resourceid", el software del panel de control busca en la misma lista de rutas de acceso de búsqueda que la función LoadLibrary (descrita en la documentación de Microsoft Windows SDK). Si esta lista de rutas de acceso no contiene el archivo, el software también busca en el directorio de controladores (consulte sección INF DestinationDirs). Este formato permite que las imágenes se almacenen fácilmente en el propio archivo del controlador sin necesidad de especificar nombres de ruta de acceso absolutos en el archivo INF.

Ejemplo 2

El ejemplo siguiente se aplica a Windows Vista y versiones posteriores de Windows. En este ejemplo se muestra una directiva de la sección add-registry-section del archivo INF de un proveedor. En este ejemplo se usa el formato "imagefile":

[ABC-Audio-Device.AddReg]
  HKR,Branding,icon,,"c:\mydir\myicon.ico"