SetupPreferredAudioDevices

Le mot clé SetupPreferredAudioDevices désigne l’appareil audio préféré, qui est l’appareil que le système audio active par défaut lorsque le système contient un ou plusieurs périphériques audio. Ce mot clé est spécifique à la classe multimédia et est pris en charge par Microsoft Windows Millennium Edition/Windows 98, Microsoft Windows 2000, Windows XP et Windows Vista. SetupPreferredAudioDevicesis n’est pas pris en charge dans Windows 7.

Lors de la création d’un appareil audio, un programme d’application peut choisir d’utiliser l’appareil par défaut (ou préféré) au lieu de spécifier explicitement un appareil. (For example, see the descriptions of the waveOutOpen and DirectSoundCreate functions in the Microsoft Windows SDK documentation.)

Le système audio effectue le suivi de l’appareil audio préféré actuel dans le registre système. Lorsqu’un utilisateur met à niveau un système en installant un nouvel appareil audio, le fichier INF propriétaire qui installe l’appareil met généralement à jour le Registre pour désigner le nouvel appareil comme périphérique audio préféré.

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. Cette directive a le format suivant :

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

La directive indique au système audio d’utiliser les fonctions audio de l’appareil comme valeurs par défaut pour la lecture audio, l’enregistrement audio et la lecture de musique 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 cette valeur est égale à zéro, la directive n’a aucun effet. 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 directive prend effet au moment où le pilote de l’appareil est installé. Si un autre appareil occupe le rôle de l’appareil préféré au moment où le nouvel appareil est installé, la directive amène le nouvel appareil à assumer le rôle de l’appareil préféré, en déplaçant l’autre appareil de ce rôle.

Lors de la mise à niveau ou de la réinstallation du pilote pour un appareil déjà installé, vous pouvez éviter de modifier les sélections actuelles de l’appareil préféré de l’utilisateur pour la lecture sonore, l’enregistrement audio et la lecture de musique 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.

exemple de

L’exemple suivant fait partie d’un fichier INF qui montre comment utiliser le mot clé SetupPreferredAudioDevices :

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

La directive à la fin de l’exemple spécifie que l’appareil nommé « XYZ-Audio-Device » est désormais le périphérique audio préféré. HKR est la clé racine de l’appareil audio dans le Registre. The flags parameter is set to 3, which is the bitwise OR of FLG_ADDREG_BINVALUETYPE and FLG_ADDREG_NOCLOBBER. Ce dernier empêche les entrées existantes du registre des appareils préférés de l’appareil d’être remplacées si l’appareil est déjà installé et que son pilote est simplement mis à niveau. Les quatre octets à la fin de la directive spécifient une valeur différente de zéro, ce qui est nécessaire pour activer la directive.

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. Pour vous assurer que le point de terminaison approprié est défini comme appareil par défaut, assurez-vous que le filtre KS qui contient le point de terminaison approprié est exposé en dernier. Vous devez le faire en raison de l’algorithme utilisé par le service AudioEndpointBuilder pour remplir les magasins de propriétés et définir les appareils par défaut.