structure KSAUDIO_PREFERRED_STATUS (ksmedia.h)
La structure KSAUDIO_PREFERRED_STATUS spécifie l’état 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 TRUE, l’appareil cible est sélectionné comme nouvel appareil préféré. Si FAUX, l’appareil cible était précédemment l’appareil préféré, mais 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, midi et topologie de mélangeur. |
| KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT | Périphérique de lecture d’onde préféré. |
| KSPROPERTY_SYSAUDIO_RECORD_DEFAULT | Appareil d’enregistrement d’onde préféré. |
| KSPROPERTY_SYSAUDIO_MIDI_DEFAULT | Périphérique 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 la carte audio actuellement sélectionnés comme préférés. 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éfini sur zéro.
Reserved
Réservé pour une utilisation ultérieure. Défini sur 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ksmedia.h (include Ksmedia.h) |