Freigeben über


SYSAUDIO_INSTANCE_INFO-Struktur (ksmedia.h)

Die SYSAUDIO_INSTANCE_INFO-Struktur gibt an, welches virtuelle Audiogerät geöffnet werden soll, und enthält Flags zum Konfigurieren dieses Geräts.

Syntax

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

Member

Property

Gibt die -Eigenschaft an. Dieser Parameter ist eine Struktur vom Typ KSPROPERTY.

Flags

Flags, die angeben, wie das virtuelle Audiogerät konfiguriert werden soll. Derzeit ist das einzige für diesen Parameter definierte Flagbit SYSAUDIO_FLAGS_DONT_COMBINE_PINS. Falls festgelegt, weist dieses Flagbit SysAudio an, Rendering-Pins nicht zu kombinieren. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

DeviceNumber

Gibt die Geräte-ID an. Dieser Member identifiziert das virtuelle Audiogerät, das durch die Eigenschaftenanforderung geöffnet werden soll. Wenn SysAudio N virtuelle Audiogeräte aufzählt (siehe KSPROPERTY_SYSAUDIO_DEVICE_COUNT), liegen die gültigen Geräte-IDs zwischen 0 und N-1.

Hinweise

Diese Struktur wird von der KSPROPERTY_SYSAUDIO_INSTANCE_INFO-Eigenschaft verwendet.

Standardmäßig kombiniert ein virtuelles Audiogerät seine Wellenrendering-Pins. Das SYSAUDIO_FLAGS_DONT_COMBINE_PINS-Flag überschreibt diese Standardeinstellung.

Wenn Pins kombiniert werden, macht das virtuelle Audiogerät eine einzelne Pinfactory verfügbar, die hardwarebeschleunigte Rendering-Pins auf dem Audiogerät mit software emulierten Mixerpins auf dem KMixer-Systemtreiber kombiniert. Wenn die Pins nicht kombiniert werden, werden hardwarebeschleunigte Pins und software emulierte Pins über separate Pin-Factorys verfügbar gemacht. Um die Anzahl der hardwarebeschleunigten Pins ordnungsgemäß an Anwendungsprogramme zu melden, erfordert DirectSound, dass die Pins nicht kombiniert werden.

Diese Eigenschaft ähnelt KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE, mit der Ausnahme, dass sie Flags enthält, die angeben, wie das virtuelle Audiogerät konfiguriert werden soll.

Anforderungen

Anforderung Wert
Header ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO