Freigeben über


KSAUDIO_PREFERRED_STATUS Struktur (ksmedia.h)

Die KSAUDIO_PREFERRED_STATUS-Struktur gibt den Status eines bevorzugten Geräts an.

Syntax

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

Angehörige

Enable

Gibt an, ob das Zielgerät das neue bevorzugte Gerät ist. Wenn TRUE, wird das Zielgerät als neues bevorzugtes Gerät ausgewählt. Wenn FALSE-, war das Zielgerät zuvor das bevorzugte Gerät, ist aber jetzt deaktiviert.

DeviceType

Gibt den Typ des bevorzugten Geräts an. Dieser Parameter wird auf eine der folgenden Konstanten festgelegt:

Wert Gerätetyp
KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT Bevorzugtes Gerät für wave playback/recording, MIDI und Mixertopologie.
KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT Bevorzugtes Wave-Wiedergabegerät.
KSPROPERTY_SYSAUDIO_RECORD_DEFAULT Bevorzugtes Wellenaufzeichnungsgerät.
KSPROPERTY_SYSAUDIO_MIDI_DEFAULT Bevorzugtes MIDI-Gerät.
KSPROPERTY_SYSAUDIO_MIXER_DEFAULT Bevorzugtes Mischertopologiegerät.

Der Treiber verwendet dieses Element, um zu bestimmen, welcher Aspekt oder welche Aspekte des Audioadapters derzeit bevorzugt ausgewählt sind. Ein Treiber kann diese Informationen verwenden, um zu entscheiden, wie sie sich selbst konfigurieren oder entscheiden, welche Systemressourcen angefordert werden sollen.

Flags

Zurzeit sind keine Flags definiert. Auf Null festgelegt.

Reserved

Reserviert für die zukünftige Verwendung. Auf Null festgelegt.

Bemerkungen

Diese Struktur wird von der KSPROPERTY_AUDIO_PREFERRED_STATUS-Eigenschaft verwendet.

Informationen zum bevorzugten Gerät finden Sie unter SetupPreferredAudioDevices.

Anforderungen

Anforderung Wert
Header- ksmedia.h (enthalten Ksmedia.h)

Siehe auch

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices