KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE
Die eigenschaft KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE erstellt eine neue virtuelle Quelle.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Filter |
ULONG |
Der Eigenschaftendeskriptor (instance Daten) ist eine Struktur vom Typ SYSAUDIO_CREATE_VIRTUAL_SOURCE, die die PIN-Kategorie- und Pinnamen-GUIDs für die virtuelle Quelle angibt.
Der Eigenschaftswert (Vorgangsdaten) ist eine ULONG-Variable, die den virtuellen Quellindex enthält. SysAudio generiert diesen Index, um die neue virtuelle Quelle zu identifizieren.
Rückgabewert
Eine KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen geeigneten Fehler status Code zurück.
Bemerkungen
Diese Eigenschaft wird verwendet, um eine virtuelle Mixerzeilenquelle zu erstellen, z. B. ein Volume- oder Stummschaltungssteuerelement.
Wenn SysAudio bereits eine virtuelle Quelle mit den gleichen PIN-Kategorie- und Pinnamen-GUIDs erstellt hat, ruft eine KSPROPERTY_SYSAUDIO_CREATE_VIRTUAL_SOURCE get-property-Anforderung den Index für die vorhandene virtuelle Quelle ab. Andernfalls generiert die Anforderung einen neuen virtuellen Quellindex und gibt diesen Wert aus.
Nachdem SysAudio einer virtuellen Quelle einen Index zugewiesen hat, kann eine KSPROPERTY_SYSAUDIO_ATTACH_VIRTUAL_SOURCESet-Property-Anforderung verwendet werden, um diese virtuelle Quelle an eine Pin-instance auf dem virtuellen Audiogerät anzufügen.
Der Benutzer steuert die Lautstärken verschiedener Audioquellen über die SndVol32-Anwendung. Zu diesen Quellen gehören das Wave-Output-Gerät, MIDI-Synthesizer, CD-Player und Line-In-Buchse. SndVol32 verwendet die Windows-Multimediafunktionen waveOutXxx, midiOutXxx und auxXxx , um die Lautstärken für diese Quellen zu steuern. Weitere Informationen zu Windows-Multimediafunktionen finden Sie in der Microsoft Windows SDK-Dokumentation.
SysAudio fängt Volumeänderungen ab, die an diesen Geräten vorgenommen wurden, und wendet sie auf die zugehörigen virtuellen Quellen an. Wenn beispielsweise ein SOFTWARE-MIDI-Synthesizer, der eine MIDI-Datei in Wellendaten konvertiert, mit einem der Wellenrendering-Pins des virtuellen Audiogeräts verbunden ist, wendet SysAudio midiOutXxx-Volumeänderungen auf den Pin an (anstelle von waveOutXxx-Lautstärkeänderungen ). Wenn der Redbook-Systemtreiber, der digitale Audiodaten von einem CD-Player in Wellendaten konvertiert, mit einem der Wellenrendering-Pins des virtuellen Audiogeräts verbunden ist, wendet SysAudio AUXCAPS_CDAUDIO Lautstärkeänderungen auf den Pin an. Weitere Informationen zur AUXCAPS_CDAUDIO-Struktur finden Sie in der Windows SDK-Dokumentation.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |