Audiotreiber-Eigenschaftensätze

In diesem Abschnitt werden die audiospezifischen Eigenschaftensätze beschrieben, die für Audiotreiber verfügbar sind, die WDM-Kernelstreamingdienste in Microsoft Windows 2000 und höher sowie in Windows Millennium Edition (Me) und Windows 98 verwenden.

Die Verweisseite für jede Eigenschaft enthält eine Tabelle mit den folgenden Spaltenüberschriften.

Herunterladen Set Ziel Eigenschaftsdeskriptortyp Eigenschaftswerttyp

Diese Überschriften haben die folgende Bedeutung:

  • Get

    Unterstützt das KS-Zielobjekt die KSPROPERTY_TYPE_GET-Eigenschaftsanforderung? (Geben Sie ja oder nein an.)

  • Set

    Unterstützt das KS-Zielobjekt die KSPROPERTY_TYPE_SET-Eigenschaftsanforderung? (Geben Sie ja oder nein an.)

  • Target

    Das Ziel für die Anforderung ist das KS-Objekt, an das die Eigenschaftsanforderung gesendet wird. Das Ziel für eine Audioeigenschaft ist entweder ein Filter oder ein Pin. (Die Eigenschaftsanforderung gibt das Zielobjekt anhand des Kernelhandles an.)

  • Eigenschaftendeskriptortyp

    Der Eigenschaftsdeskriptor gibt die Eigenschaft und den Vorgang an, der für diese Eigenschaft ausgeführt werden soll. Der Deskriptor beginnt immer mit einer KSPROPERTY-Struktur , aber einige Deskriptortypen enthalten zusätzliche Informationen. Die KSNODEPROPERTY-Struktur ist beispielsweise ein Eigenschaftendeskriptor, der mit einer KSPROPERTY-Struktur beginnt, aber auch eine Knoten-ID enthält.

  • Eigenschaftswerttyp

    Eine Eigenschaft hat in der Regel einen Wert, und der Typ dieses Werts hängt von der Eigenschaft ab. Eine Eigenschaft, die sich beispielsweise in einem von nur zwei Zuständen befinden kann – on oder off -, weist in der Regel einen BOOL-Wert auf. Eine Eigenschaft, die ganzzahlige Werte von 0 bis 0xFFFFFFFF annehmen kann, kann einen ULONG-Wert aufweisen. Komplexere Eigenschaften können Werte aufweisen, die Arrays oder Strukturen sind.

Der vorangehende Eigenschaftsdeskriptor und der Eigenschaftenwert sind die eigenschaftenspezifischen Versionen der instance-Spezifikations- und Vorgangsdatenpuffer, die unter KS-Eigenschaften, Ereignisse und Methoden erläutert werden.

Eine Eigenschaftsanforderung verwendet eines der folgenden Flags, um den Vorgang anzugeben, der für die -Eigenschaft ausgeführt werden soll:

  • KSPROPERTY_TYPE_BASICSUPPORT

  • KSPROPERTY_TYPE_GET

  • KSPROPERTY_TYPE_SET

Alle Filter- und Pinobjekte unterstützen den Basic-Support-Vorgang für ihre Eigenschaften. Ob sie die Get- und Set-Vorgänge unterstützen, hängt von der -Eigenschaft ab. Eine Eigenschaft, die eine inhärente Funktion des Filter- oder Anheftobjekts darstellt, erfordert wahrscheinlich nur einen Get-Vorgang. Eine Eigenschaft, die eine konfigurierbare Einstellung darstellt, erfordert möglicherweise nur einen Set-Vorgang, obwohl ein Get-Vorgang auch zum Lesen der aktuellen Einstellung nützlich sein kann. Weitere Informationen zur Verwendung der Vorgänge get, set und basic-support mit Audioeigenschaften finden Sie unter Audioendpunkte, Eigenschaften und Ereignisse.

Die folgenden Eigenschaftensätze sind für Audiotreiber definiert:

KSPROPSETID_AC3

KSPROPSETID_Acoustic_Echo_Cancel

KSPROPSETID_Audio

KSPROPSETID_AudioEngine

KSPROPSETID_AudioGfx

KSPROPSETID_AudioLoopback

KSPROPSETID_AudioModule

KSPROPSETID_BtAudioModule

KSPROPSETID_DirectSound3DBuffer

KSPROPSETID_DirectSound3DListener

KSPROPSETID_DrmAudioStream

KSPROPSETID_FMRXControl

KSPROPSETID_FMRXTopology

KSPROPSETID_Hrtf3d

KSPROPSETID_Itd3d

KSPROPSETID_Jack

KSPROPSETID_RTAudio

KSPROPSETID_SoundDetector

KSPROPSETID_SoundDetector2

KSPROPSETID_Synth

KSPROPSETID_SynthClock

KSPROPSETID_Synth_Dls

KSPROPSETID_Sysaudio

KSPROPSETID_Sysaudio_Pin

KSPROPSETID_TelephonyControl

KSPROPSETID_TelephonyTopology

KSPROPSETID_TopologyNode