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_Acoustic_Echo_Cancel
KSPROPSETID_DirectSound3DBuffer