KSPROPERTY_AUDIO_ALGORITHM_INSTANCE

Die KSPROPERTY_AUDIO_ALGORITHM_INSTANCE-Eigenschaft gibt den DSP-Algorithmus (Digital Signal Processing) an, der verwendet wird, um den Drittanbietereffekt zu erzielen, den der Knoten auf den Audiodatenstrom anwendet. Zu den für diese Eigenschaft definierten Effekten gehören akustische Echounterdrückung und Rauschunterdrückung.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Ja	Ja	Filter	KSNODEPROPERTY	GUID

Der Eigenschaftswert (Vorgangsdaten) ist eine GUID, die den Effekt identifiziert, den der Pin auf den Datenstrom anwendet. Dieser Wert kann eine der folgenden GUIDs aus der Headerdatei Ksmedia.h sein:

KSALGORITHMINSTANCE_SYSTEM_AGC
Für die zukünftige Verwendung reserviert

KSALGORITHMINSTANCE_SYSTEM_ACOUSTIC_ECHO_CANCEL
Systemstandardalgorithmus für akustische Echounterdrückung

KSALGORITHMINSTANCE_SYSTEM_MICROPHONE_ARRAY_PROCESSOR
Für die zukünftige Verwendung reserviert

KSALGORITHMINSTANCE_SYSTEM_NOISE_SUPPRESS
Systemstandardalgorithmus zur Rauschunterdrückung

Rückgabewert

Eine KSPROPERTY_AUDIO_ALGORITHM_INSTANCE-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt die Anforderung einen entsprechenden Fehler status Code zurück.

Bemerkungen

Diese Eigenschaft wird verwendet, um den DSP-Algorithmus zu steuern, der von einem AEC-Knoten (KSNODETYPE_ACOUSTIC_ECHO_CANCEL) oder einem Rauschunterdrückungsknoten (KSNODETYPE_NOISE_SUPPRESS) ausgeführt wird.

Die algorithmus-instance GUID entspricht dem Wert im guidDSCFXInstance-Member einer DSCEFFECTDESC-Struktur, den ein Aufrufer an die IDirectSoundCapture::CreateCaptureBuffer-Methode oder directSoundFullDuplexCreate-Funktion übergibt. Weitere Informationen finden Sie in der Microsoft Windows SDK-Dokumentation.

Anforderungen

Header

Ksmedia.h (include Ksmedia.h)

Siehe auch

KSNODEPROPERTY

KSNODETYPE_ACOUSTIC_ECHO_CANCEL

KSNODETYPE_NOISE_SUPPRESS