KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST
Die KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST-Eigenschaft ist eine Filtereigenschaft, deren Wert eine Liste von Audioeffekttypen ist, die auf eine bestimmte KS-Pinfactory für einen bestimmten Audiosignalverarbeitungspfad angewendet werden.
Nutzungszusammenfassungstabelle
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Ja |
Nein |
Pin Factory (über Filter instance) |
KSP_PIN |
KSP_PINMODE |
Der Eigenschaftswert ist ein Array von 0 oder mehr Audioeffekttyp-GUIDs (z. B. AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION), die sich im Signalverarbeitungspfad des Pins befinden, der durch die KSP_PINMODE-Struktur identifiziert wird.
Hinweis Das KSPROPERTY_TYPE_TOPOLOGY-Flagbit darf für diese Eigenschaft nicht festgelegt werden.
Rückgabewert
Die KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST-Eigenschaftsanforderung gibt STATUS_SUCCESS zurück, um anzugeben, dass sie erfolgreich abgeschlossen wurde. Andernfalls gibt diese Eigenschaftsanforderung einen geeigneten Fehler status Code zurück.
Bemerkungen
Wenn ein Audiotreiber den generischen Proxy-APO von Microsoft verwendet, um die Audioeffekte abzurufen, die in den verschiedenen Signalverarbeitungspfaden für einen KS-Pin enthalten sind, muss er diese Eigenschaft unterstützen. Der generische Proxy-APO ist in der msapofxproxy.dll-Datei enthalten. Audiotreiber können diesen generischen Proxy-APO verwenden, wenn die gesamte Signalverarbeitung im Audiotreiber oder in der entsprechenden DSP-Hardwarekomponente (Digital Signal Processor) erfolgt, ohne dass die Verarbeitung in einem APO erfolgt. In diesem Fall besteht die einzige Funktion des APO darin, die Signalverarbeitungseffekte an das Audiosystem zu melden.
Der generische Proxy-APO empfängt KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST vom Audiotreiber und verwendet ihn, um die Effekte an das Audiosystem zu melden. Der generische Proxy-APO geht davon aus, dass sich die Liste der Effekte nicht ändert, während die Filterschnittstelle des KS-Pins aktiviert ist.
Wenn der Eigenschaftendeskriptor einen KS-Pin angibt, der KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST nicht unterstützt, muss der Treiber STATUS_NOT_SUPPORTED zurückgeben.
Wenn der Eigenschaftendeskriptor einen AudioProcessingMode-Wert angibt, den der Treiber nicht unterstützt, muss der Treiber STATUS_INVALID_PARAMETER zurückgeben. Beachten Sie, dass ein Audiotreiber die eigenschaft KSPROPERTY_AUDIOSIGNALPROCESSING_MODES unterstützen muss, um die unterstützten Audiosignalverarbeitungsmodi angeben zu können.
Requirements (Anforderungen)
Version |
Windows 8.1 |
Header |
Msapofxproxy.h |