Kern-Audioschnittstellen

Diese Programmierreferenz für das Core Audio SDK umfasst die folgenden Schnittstellen:

MMDevice-API

Die MMDevice-API (Windows Multimedia Device) ermöglicht Es Audioclients, Audioendpunkte zu ermitteln, ihre Funktionen zu bestimmen und Treiberinstanzen für diese Geräte zu erstellen. Die Headerdatei Mmdeviceapi.h definiert die Schnittstellen in der MMDevice-API. Weitere Informationen finden Sie unter Informationen zur MMDevice-API.

In der folgenden Tabelle sind die MMDevice-Schnittstellen aufgeführt, die mit dem Core Audio SDK für Windows Vista verfügbar sind.

Schnittstelle	BESCHREIBUNG
IMMDevice	Stellt ein Audiogerät dar.
IMMDeviceCollection	Stellt eine Sammlung von Audiogeräten dar.
IMMDeviceEnumerator	Stellt Methoden zum Auflisten von Audiogeräten bereit.
IMMEndpoint	Stellt ein Audioendpunktgerät dar.
IMMNotificationClient	Stellt Benachrichtigungen bereit, wenn ein Audioendpunktgerät hinzugefügt oder entfernt wird, wenn sich der Zustand oder die Eigenschaften eines Geräts ändern oder wenn die Standardrolle geändert wird, die einem Gerät zugewiesen ist.

WASAPI

Mit der Windows-Audiositzungs-API (WASAPI) können Clientanwendungen den Fluss von Audiodaten zwischen der Anwendung und einem Audioendpunktgerät verwalten. Headerdateien Audioclient.h und Audiopolicy.h definieren die WASAPI-Schnittstellen. Weitere Informationen finden Sie unter Informationen zu WASAPI.

In der folgenden Tabelle sind die WASAPI-Schnittstellen aufgeführt, die mit dem Core Audio SDK für Windows Vista und höher verfügbar sind.

Schnittstelle	BESCHREIBUNG
IActivateAudioInterfaceAsyncOperation	Stellt einen asynchronen Vorgang dar, der eine WASAPI-Schnittstelle aktiviert, und stellt eine Methode zum Abrufen der Aktivierungsergebnisse bereit. Gilt ab Windows 8.
IActivateAudioInterfaceCompletionHandler	Stellt einen Rückruf bereit, um anzugeben, dass die Aktivierung einer WASAPI-Schnittstelle abgeschlossen ist. Gilt ab Windows 8.
IAudioCaptureClient	Ermöglicht einem Client das Lesen von Eingabedaten aus einem Erfassungsendpunktpuffer.
IAudioClient	Ermöglicht einem Client das Erstellen und Initialisieren eines Audiodatenstroms zwischen einer Audioanwendung und der Audio-Engine oder dem Hardwarepuffer eines Audioendpunktgeräts.
IAudioClock	Ermöglicht es einem Client, die Datenrate eines Datenstroms und die aktuelle Position im Stream zu überwachen.
IAudioClock2	Ermöglicht einem Client das Abrufen der aktuellen Geräteposition.
IAudioClockAdjustment	Ermöglicht es einem Client, die Abtastrate eines Datenstroms festzulegen.
IAudioRenderClient	Ermöglicht einem Client das Schreiben von Ausgabedaten in einen Renderingendpunktpuffer.
IAudioSessionControl	Ermöglicht es einem Client, die Steuerungsparameter für eine Audiositzung zu konfigurieren und Ereignisse in der Sitzung zu überwachen.
IAudioSessionControl2	Ermöglicht einem Client das Abrufen von Informationen zur Audiositzung.
IAudioSessionManager	Ermöglicht einem Client den Zugriff auf die Sitzungs- und Volumesteuerelemente für prozessübergreifende und prozessspezifische Audiositzungen.
IAudioSessionManager2	Verwaltet alle Submixe, einschließlich Enumeration und Benachrichtigung von Teilmischungen. Es bietet auch Unterstützung für Ducking-Benachrichtigungen.
IAudioSessionEnumerator	Ermöglicht einem Client das Aufzählen von Audiositzungen.
IAudioStreamVolume	Ermöglicht es einem Client, die Lautstärkepegel für alle Kanäle in einem Audiostream zu steuern und zu überwachen.
IChannelAudioVolume	Ermöglicht einem Client die Steuerung der Lautstärkepegel für alle Kanäle in der Audiositzung, zu der der Stream gehört.
ISimpleAudioVolume	Ermöglicht es einem Client, die master Lautstärkepegel einer Audiositzung zu steuern.
IAudioSessionEvents	Stellt Benachrichtigungen zu sitzungsbezogenen Ereignissen bereit, z. B. Änderungen der Volumeebene, des Anzeigenamens und des Sitzungszustands.
IAudioSessionNotification	Sendet Benachrichtigungen, wenn Sitzungsänderungen auftreten.
IAudioVolumeDuckNotification	Sendet Benachrichtigungen über ausstehende System-Ducking-Änderungen.

DeviceTopology-API

Die DeviceTopology-API bietet Clientanwendungen die Möglichkeit, die funktionalen Hardwaretopologien von Audiorendering- und Aufzeichnungsgeräten zu durchlaufen. Die Headerdatei Devicetopology.h definiert die Schnittstellen in der DeviceTopology-API. Weitere Informationen finden Sie unter Gerätetopologien und DeviceTopology-API.

In der folgenden Tabelle sind die DeviceTopology-Schnittstellen aufgeführt, die mit dem Core Audio SDK für Windows Vista und höher verfügbar sind.

Schnittstelle	BESCHREIBUNG
IAudioAutoGainControl	Ermöglicht den Zugriff auf eine automatische Verstärkungssteuerung (Hardware Automatic Gain Control, AGC).
IAudioBass	Ermöglicht den Zugriff auf eine Hardwaresteuerung auf Bassebene.
IAudioChannelConfig	Ermöglicht den Zugriff auf ein Hardwarekanalkonfigurationssteuerelement.
IAudioInputSelector	Ermöglicht den Zugriff auf ein Hardware-Multiplexer-Steuerelement (Eingabeauswahl).
IAudioLoudness	Ermöglicht den Zugriff auf ein "Lautstärke"-Kompensationssteuerelement.
IAudioMidrange	Ermöglicht den Zugriff auf ein Hardware-Midrange-Level-Steuerelement.
IAudioMute	Ermöglicht den Zugriff auf ein Hardware stummschaltbares Steuerelement.
IAudioOutputSelector	Ermöglicht den Zugriff auf ein Hardwaredemultiplexer-Steuerelement (Ausgabeauswahl).
IAudioPeakMeter	Ermöglicht den Zugriff auf ein Hardware-Peak-Meter-Steuerelement.
IAudioTreble	Ermöglicht den Zugriff auf ein Hardwaresteuerelement auf Dreifachebene.
IAudioVolumeLevel	Ermöglicht den Zugriff auf eine Hardwarevolumesteuerung.
IConnector	Stellt einen Verbindungspunkt zwischen Komponenten dar.
IControlInterface	Stellt eine Steuerelementschnittstelle für ein Teil (Untereinheit oder Connector) dar.
IDeviceSpecificProperty	Stellt eine gerätespezifische Eigenschaft eines Connectors oder einer Untereinheit dar.
IDeviceTopology	Bietet Zugriff auf die Topologie eines Audiogeräts.
IKsFormatSupport	Stellt Informationen zu den Audiodatenformaten bereit, die von einer softwarekonfigurierten E/A-Verbindung (in der Regel ein DMA-Kanal) zwischen dem Audiogerät und dem Systemspeicher unterstützt werden.
IKsJackDescription	Stellt Informationen zu den Buchsen oder internen Anschlüssen bereit, die eine physische Verbindung zwischen einem Gerät an einem Audioadapter und einem externen oder internen Endpunktgerät (z. B. mikrofon oder CD-Player) bereitstellen.
IKsJackDescription2	Bietet bequemen Zugriff auf die KSPROPERTY_JACK_DESCRIPTION2-Eigenschaft eines Connectors für ein Endpunktgerät.
IKsJacksinkInformation	Stellt Informationen zur Senke der Buchse bereit, wenn die Buchse von der Hardware unterstützt wird.
Ipart	Stellt einen Teil (Connector oder Untereinheit) einer Gerätetopologie dar.
IPartsList	Stellt eine Liste von Teilen (Connectors und Untereinheiten) dar.
IPerChannelDbLevel	Stellt eine generische Untereinheitssteuerungsschnittstelle dar, die kanalspezifische Steuerung über den Lautstärkepegel eines Audiodatenstroms oder eines Frequenzbands in einem Audiodatenstrom in Dezibel ermöglicht.
ISubunit	Stellt eine Hardwareuntereinheit (z. B. eine Steuerung auf Lautstärkeebene) dar, die sich im Datenpfad zwischen einem Client und einem Audioendpunktgerät befindet.
IControlChangeNotify	Stellt Benachrichtigungen bereit, wenn sich die status eines Teils (Connector oder Untereinheit) ändert.

EndpointVolume-API

Die EndpointVolume-API ermöglicht es spezialisierten Clients, die Lautstärken von Audioendpunktgeräten zu steuern und zu überwachen. Die Headerdatei Endpointvolume.h definiert die Schnittstellen in der EndpointVolume-API. Weitere Informationen finden Sie unter EndpointVolume-API .

In der folgenden Tabelle sind die EndpointVolume-Schnittstellen aufgeführt, die mit dem Core Audio SDK für Windows Vista verfügbar sind.

Interface	Beschreibung
IAudioEndpointVolume	Stellt die Lautstärkeregler für den Audiodatenstrom an oder von einem Audioendpunktgerät dar.
IAudioEndpointVolumeEx	Stellt Lautstärkesteuerungen für den Audiodatenstrom an oder von einem Geräteendpunkt bereit.
IAudioMeterInformation	Stellt einen Spitzenzähler für den Audiodatenstrom an oder von einem Audioendpunktgerät dar.
IAudioEndpointVolumeCallback	Stellt Benachrichtigungen bereit, wenn sich die Lautstärke oder der Stummschaltungszustand eines Audioendpunktgeräts ändert.

Zugehörige Themen

Programmierverzeichnis