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) |