KSPROPERTY_SYSAUDIO_SELECT_GRAPH
Die KSPROPERTY_SYSAUDIO_SELECT_GRAPH-Eigenschaft wird verwendet, um explizit einen optionalen Knoten in den Graphen einzuschließen, den SysAudio für eine Pin instance auf einem virtuellen Audiogerät erstellt.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Nein |
Ja |
Filter |
Keine |
Der Eigenschaftendeskriptor (instance Daten) ist eine Struktur vom Typ SYSAUDIO_SELECT_GRAPH, die die Eigenschaft, die Pin-ID und die Knoten-ID angibt. Die -Eigenschaft wird durch eine eingebettete Struktur vom Typ KSPROPERTY angegeben. Die Pin-ID ist ein Index, der eine Pinfactory im KS-Filter identifiziert, der das virtuelle Audiogerät umschließt. Die Knoten-ID ist ein Index, der einen optionalen Knoten im Datenpfad des angegebenen Pins identifiziert. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Für diese Eigenschaft ist kein Eigenschaftswert (Vorgangsdaten) definiert. Geben Sie den Pufferzeiger des Eigenschaftswerts als NULL und dessen Größe als Null an.
Rückgabewert
Eine KSPROPERTY_SYSAUDIO_SELECT_GRAPH-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 in der Regel verwendet, um einen AEC-Knoten in das Diagramm für eine Pin-instance zu erzwingen.
Beim Instanziieren eines Rendering-Pins im Filter für ein virtuelles Audiogerät beginnt SysAudio am Pin und wählt standardmäßig das Diagramm aus, das den einfachsten Pfad durch den Filter darstellt. Dieses Diagramm schließt alle optionalen Knoten aus, z. B. AEC-Steuerelemente.
Sie können das Standardverhalten von SysAudio überschreiben, indem Sie SysAudio zuerst eine KSPROPERTY_SYSAUDIO_SELECT_GRAPH Set-Property-Anforderung senden, die den optionalen Knoten angibt, der in das Diagramm eingeschlossen werden soll. Wenn SysAudio anschließend den Pin instance erstellt, enthält das Diagramm des Pins den optionalen Knoten, der in der Anforderung angegeben wurde.
Eine KSPROPERTY_SYSAUDIO_SELECT_GRAPH Set-Property-Anforderung wirkt sich nur auf Pininstanzen aus, die nach der Anforderung erstellt werden. Die Anforderung hat keine Auswirkungen auf zuvor instanziierte Pins.
Anforderungen
Header |
Ksmedia.h (einschließlich Ksmedia.h) |