KSAUDIO_PREFERRED_STATUS-Struktur (ksmedia.h)
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) |