SetupPreferredAudioDevices

La palabra clave SetupPreferredAudioDevices denota el dispositivo de audio preferido, que es el dispositivo que el sistema de audio habilita de forma predeterminada cuando el sistema contiene uno o varios dispositivos de audio. Esta palabra clave es específica de clase multimedia y es compatible con Microsoft Windows Millennium Edition/Windows 98, Microsoft Windows 2000, Windows XP y Windows Vista. SetupPreferredAudioDevicesis no se admite en Windows 7.

Al crear un dispositivo de audio, un programa de aplicación puede optar por usar el dispositivo predeterminado (o preferido) en lugar de especificar explícitamente un dispositivo. (For example, see the descriptions of the waveOutOpen and DirectSoundCreate functions in the Microsoft Windows SDK documentation.)

El sistema de audio realiza un seguimiento del dispositivo de audio preferido actual en el registro del sistema. Cuando un usuario actualiza un sistema instalando un nuevo dispositivo de audio, el archivo INF propietario que instala el dispositivo normalmente actualiza el registro para designar el nuevo dispositivo como dispositivo de audio preferido.

The SetupPreferredAudioDevices keyword can appear within a registry-update directive in the add-registry-section (see INF AddReg Directive) of an INF file for an audio device. Esta directiva tiene el formato siguiente:

reg-rootkey, [reg-subkey]SetupPreferredAudioDevices [flags], [dword-value]

La directiva indica al sistema de audio que use las funciones de audio del dispositivo como los valores predeterminados para la reproducción de sonido, la grabación de sonido y la reproducción de música MIDI. Following installation, these three defaults appear in the Sounds and Multimedia control panel under the Audio tab. The user can use Control Panel to change the default devices.

The directive's dword-value parameter specifies a DWORD value that should be nonzero in order to enable the directive. Si este valor es cero, la directiva no tiene ningún efecto. Because Windows Me/98 do not support the REG_DWORD registry data type, however, dword-value is typically expressed as a 4-byte REG_BINARY type instead of as a DWORD (for example, as "01,00,00,00" instead of "0x00000001"). The dword-value parameter can be specified in raw binary format by setting the directive's flags parameter to "1" (FLG_ADDREG_BINVALUETYPE).

La directiva surte efecto en el momento en que se instala el controlador del dispositivo. Si otro dispositivo ocupa el rol de dispositivo preferido en el momento en que se instala el nuevo dispositivo, la directiva hace que el nuevo dispositivo asuma el rol de dispositivo preferido, lo que desplaza al otro dispositivo de este rol.

Al actualizar o reinstalar el controlador para un dispositivo que ya se ha instalado, es posible que quiera evitar modificar las selecciones de dispositivo preferidas actuales del usuario para la reproducción de sonido, la grabación de sonido y la reproducción de música MIDI. If so, set the FLG_ADDREG_NOCLOBBER bit in the flags parameter, which causes the directive to take effect only if this is the device's initial installation.

Ejemplo de

El ejemplo siguiente es una parte de un archivo INF que muestra cómo usar la palabra clave SetupPreferredAudioDevices:

  AddReg = XYZ-Audio-Device.AddReg
  ...
  [XYZ-Audio-Device.AddReg]
  HKR,,SetupPreferredAudioDevices,3,01,00,00,00

La directiva al final del ejemplo especifica que el dispositivo denominado "XYZ-Audio-Device" es ahora el dispositivo de audio preferido. HKR es la clave raíz del dispositivo de audio en el Registro. The flags parameter is set to 3, which is the bitwise OR of FLG_ADDREG_BINVALUETYPE and FLG_ADDREG_NOCLOBBER. Esto último impide que las entradas del registro de dispositivos preferidos existentes del dispositivo se sobrescriban en caso de que el dispositivo ya esté instalado y que su controlador se esté actualizando. Los cuatro bytes al final de la directiva especifican un valor distinto de cero, que es necesario para habilitar la directiva.

With the current implementation of the SetupPreferredAudioDevices keyword in Windows Vista, any audio endpoint with its dword-value set to an odd number can be set as the default device. Para asegurarse de que el punto de conexión correcto está establecido como dispositivo predeterminado, asegúrese de que el filtro KS que contiene el punto de conexión correspondiente se expone en último lugar. Debe hacerlo debido al algoritmo que usa el servicio AudioEndpointBuilder para rellenar los almacenes de propiedades y establecer dispositivos predeterminados.