IKsFormatSupport-Schnittstelle (devicetopology.h)

Die IKsFormatSupport-Schnittstelle stellt Informationen zu den Audiodatenformaten bereit, die von einer softwarekonfigurierten E/A-Verbindung (in der Regel ein DMA-Kanal) zwischen einem Audioadaptergerät und dem Systemspeicher unterstützt werden. Der Client ruft einen Verweis auf die IKsFormatSupport-Schnittstelle eines Teils ab, indem die IPart::Activate-Methode aufgerufen wird, wobei der Parameter refiid auf REFIID IID_IKsFormatSupport festgelegt ist. Der Aufruf von IPart::Activate ist nur erfolgreich, wenn das Teil die IKsFormatSupport-Schnittstelle unterstützt. Nur ein Teilobjekt, das einen Connector mit einem Software_IO Verbindungstyp darstellt, unterstützt diese Schnittstelle. Weitere Informationen zu Software_IO finden Sie unter ConnectorType-Enumeration.

Die meisten Windows-Audioadaptertreiber unterstützen das Windows-Treibermodell (WDM) und verwenden Kernelstreamingeigenschaften (KS), um die Hardwarebeschreibungsparameter in Connectors darzustellen (als KS-Pins bezeichnet). Die IKsFormatSupport-Schnittstelle bietet bequemen Zugriff auf die KSPROPERTY_PIN_DATAINTERSECTION und KSPROPERTY_PIN_PROPOSEDDATAFORMAT Eigenschaften eines Anschlusses an einen Systembus (üblicherweise PCI oder PCI Express) oder einen externen Bus (z. B. USB). Nicht alle Treiber unterstützen die eigenschaft KSPROPERTY_PIN_PROPOSEDDATAFORMAT. Wenn ein Treiber diese Eigenschaft nicht unterstützt, verwendet IKsFormatSupport die Informationen in den KS-Datenbereichen für den Connector, um zu bestimmen, ob der Connector das vorgeschlagene Format unterstützt. Weitere Informationen zu KS-Eigenschaften, KS-Pins und KS-Datenbereichen finden Sie in der Dokumentation zu Windows DDK.

Vererbung

Die IKsFormatSupport-Schnittstelle erbt von der IUnknown-Schnittstelle . IKsFormatSupport verfügt auch über folgende Arten von Membern:

Methoden

Die IKsFormatSupport-Schnittstelle verfügt über diese Methoden.

IKsFormatSupport::GetDevicePreferredFormat Die GetDevicePreferredFormat-Methode ruft das bevorzugte Audiostreamformat für die Verbindung ab.
IKsFormatSupport::IsFormatSupported Die IsFormatSupported-Methode gibt an, ob das Audioendpunktgerät das angegebene Audiostreamformat unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

Kern-Audioschnittstellen

DeviceTopology-API

IPart::Activate