Partager via


structure KSAUDIO_PREFERRED_STATUS (ksmedia.h)

La structure KSAUDIO_PREFERRED_STATUS spécifie la status d’un appareil préféré.

Syntaxe

typedef struct {
  BOOL                             Enable;
  KSPROPERTY_SYSAUDIO_DEFAULT_TYPE DeviceType;
  ULONG                            Flags;
  ULONG                            Reserved;
} KSAUDIO_PREFERRED_STATUS, *PKSAUDIO_PREFERRED_STATUS;

Membres

Enable

Spécifie si l’appareil cible est le nouvel appareil préféré. Si la valeur est TRUE, l’appareil cible est sélectionné comme nouvel appareil préféré. Si la valeur est FALSE, l’appareil cible était auparavant l’appareil préféré, mais il est maintenant désélectionné.

DeviceType

Spécifie le type d’appareil préféré. Ce paramètre est défini sur l’une des constantes suivantes :

Valeur Type d’appareil
KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT Appareil préféré pour la lecture/enregistrement d’ondes, la topologie MIDI et mixer.
KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT Appareil de lecture d’ondes préféré.
KSPROPERTY_SYSAUDIO_RECORD_DEFAULT Appareil d’enregistrement d’ondes préféré.
KSPROPERTY_SYSAUDIO_MIDI_DEFAULT Appareil MIDI préféré.
KSPROPERTY_SYSAUDIO_MIXER_DEFAULT Appareil de topologie de mélangeur préféré.

Le pilote utilise ce membre pour déterminer l’aspect ou les aspects de l’adaptateur audio actuellement sélectionnés par défaut. Un pilote peut utiliser ces informations pour décider comment se configurer ou décider des ressources système à demander.

Flags

Aucun indicateur n’est actuellement défini. Définit la valeur zéro.

Reserved

Réservé pour un usage futur. Définit la valeur zéro.

Remarques

Cette structure est utilisée par la propriété KSPROPERTY_AUDIO_PREFERRED_STATUS .

Pour plus d’informations sur l’appareil préféré, consultez SetupPreferredAudioDevices.

Configuration requise

Condition requise Valeur
En-tête ksmedia.h (inclure Ksmedia.h)

Voir aussi

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices