KSAUDIO_PREFERRED_STATUS-Struktur (ksmedia.h)

  • Artikel

Die KSAUDIO_PREFERRED_STATUS-Struktur gibt die 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;

Member

Enable

Gibt an, ob das Zielgerät das neue bevorzugte Gerät ist. Bei TRUE wird das Zielgerät als neues bevorzugtes Gerät ausgewählt. False gibt an, dass das Zielgerät zuvor das bevorzugte Gerät war, aber jetzt deaktiviert ist.

DeviceType

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

Wert Gerätetyp
KSPROPERTY_SYSAUDIO_NORMAL_DEFAULT Bevorzugtes Gerät für die Wellenwiedergabe/-aufnahme, MIDI- und Mixertopologie.
KSPROPERTY_SYSAUDIO_PLAYBACK_DEFAULT Bevorzugtes Wave-Wiedergabegerät.
KSPROPERTY_SYSAUDIO_RECORD_DEFAULT Bevorzugtes Wave-Aufzeichnungsgerät.
KSPROPERTY_SYSAUDIO_MIDI_DEFAULT Bevorzugtes MIDI-Gerät.
KSPROPERTY_SYSAUDIO_MIXER_DEFAULT Bevorzugtes Mixertopologiegerät.

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

Flags

Derzeit sind keine Flags definiert. Auf NULL festlegen.

Reserved

Für die zukünftige Verwendung reserviert. Auf NULL festlegen.

Hinweise

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 (include Ksmedia.h)

Weitere Informationen

KSPROPERTY_AUDIO_PREFERRED_STATUS

SetupPreferredAudioDevices