Podstawowe interfejsy audio

Ta dokumentacja programowania dla podstawowego zestawu SDK audio obejmuje następujące interfejsy:

MMDevice API

Interfejs API urządzenia multimedialnego z systemem Windows (MMDevice) umożliwia klientom audio odnajdywanie urządzeń punktu końcowego audio , określanie ich możliwości i tworzenie wystąpień sterowników dla tych urządzeń. Plik nagłówka Mmdeviceapi.h definiuje interfejsy w interfejsie API MMDevice. Aby uzyskać więcej informacji, zobacz Informacje o interfejsie API MMDevice.

W poniższej tabeli wymieniono interfejsy MMDevice dostępne w zestawie Core Audio SDK dla systemu Windows Vista.

Interfejs	Opis
IMMDevice	Reprezentuje urządzenie audio.
IMMDeviceCollection	Reprezentuje kolekcję urządzeń audio.
IMMDeviceEnumerator	Udostępnia metody wyliczania urządzeń audio.
IMMEndpoint	Reprezentuje urządzenie punktu końcowego audio.
IMMNotificationClient	Dostarcza powiadomienia, gdy urządzenie punktu końcowego audio zostanie dodane lub usunięte, gdy stan lub właściwości urządzenia ulegnie zmianie lub gdy nastąpi zmiana roli domyślnej przypisanej do urządzenia.

WASAPI

Interfejs API sesji audio systemu Windows (WASAPI) umożliwia aplikacjom klienckim zarządzanie przepływem danych audio między aplikacją a urządzeniem punktu końcowego audio . Pliki nagłówkowe Audioclient.h i Audiopolicy.h definiują interfejsy WASAPI. Aby uzyskać więcej informacji, zobacz About WASAPI.

W poniższej tabeli wymieniono interfejsy WASAPI dostępne w zestawie Core Audio SDK dla systemu Windows Vista i nowszych wersjach.

Interfejs	Opis
IActivateAudioInterfaceAsyncOperation	Reprezentuje operację asynchroniczną aktywując interfejs WASAPI i udostępnia metodę pobierania wyników aktywacji. Dotyczy począwszy od systemu Windows 8.
IActivateAudioInterfaceCompletionHandler	Udostępnia wywołanie zwrotne wskazujące, że aktywacja interfejsu WASAPI została ukończona. Dotyczy począwszy od systemu Windows 8.
IAudioCaptureClient	Umożliwia klientowi odczytywanie danych wejściowych z buforu punktu końcowego przechwytywania.
IAudioClient	Umożliwia klientowi tworzenie i inicjowanie strumienia audio między aplikacją audio a aparatem audio lub buforem sprzętowym urządzenia punktu końcowego audio.
IAudioClock	Umożliwia klientowi monitorowanie szybkości danych strumienia i bieżącej pozycji w strumieniu.
IAudioClock2	Umożliwia klientowi uzyskanie bieżącej pozycji urządzenia.
IAudioClockAdjustment	Umożliwia klientowi ustawienie częstotliwości próbkowania strumienia.
IAudioRenderClient	Umożliwia klientowi zapisywanie danych wyjściowych w buforze punktu końcowego renderowania.
IAudioSessionControl	Umożliwia klientowi skonfigurowanie parametrów sterowania dla sesji audio i monitorowanie zdarzeń w sesji.
IAudioSessionControl2	Umożliwia klientowi uzyskanie informacji o sesji audio.
IAudioSessionManager	Umożliwia klientowi dostęp do kontrolek sesji i kontrolek głośności zarówno dla sesji dźwiękowych obejmujących wiele procesów, jak i procesów.
IAudioSessionManager2	Zarządza wszystkimi podmiksami, w tym wyliczeniem i powiadomieniem o podmiksach. Zapewnia również obsługę powiadomień ducking.
IAudioSessionEnumerator	Umożliwia klientowi wyliczanie sesji audio.
IAudioStreamVolume	Umożliwia klientowi kontrolowanie i monitorowanie poziomów głośności dla wszystkich kanałów w strumieniu audio.
IChannelAudioVolume	Umożliwia klientowi kontrolowanie poziomów głośności dla wszystkich kanałów w sesji audio, do których należy strumień.
ISimpleAudioVolume	Umożliwia klientowi kontrolowanie głównego poziomu głośności sesji audio.
IAudioSessionEvents	Dostarcza powiadomienia o zdarzeniach związanych z sesją, takich jak zmiany na poziomie woluminu, nazwa wyświetlana i stan sesji.
IAudioSessionNotification	Wysyła powiadomienia o zmianach sesji.
IAudioVolumeDuckNotification	Wysyła powiadomienia o oczekujących zmianach w systemie.

Interfejs APItopologii urządzenia

Interfejs API DeviceTopology udostępnia aplikacjom klienckim możliwość przechodzenia funkcjonalnych topologii sprzętu renderowania audio i przechwytywania urządzeń. Plik nagłówkowy Devicetopology.h definiuje interfejsy w interfejsie API DeviceTopology. Aby uzyskać więcej informacji, zobacz Device Topologies and DeviceTopology API.

W poniższej tabeli wymieniono interfejsy DeviceTopology dostępne w zestawie Core Audio SDK dla systemu Windows Vista i nowszych wersjach.

Interfejs	Opis
IAudioAutoGainControl	Zapewnia dostęp do sprzętowej automatycznej kontroli przyrostu (AGC).
IAudioBasss	Zapewnia dostęp do sprzętowej kontroli poziomu basu.
IAudioChannelConfig	Zapewnia dostęp do sprzętowej kontroli konfiguracji kanału.
IAudioInputSelector	Zapewnia dostęp do sprzętowej kontrolki multipleksera (selektora danych wejściowych).
IAudioLoudness	Zapewnia dostęp do kontroli kompensacji "głośności".
IAudioMidrange	Zapewnia dostęp do sprzętowej kontroli na poziomie średniego poziomu.
IAudioMute	Zapewnia dostęp do sprzętowej kontroli wyciszenia.
IAudioOutputSelector	Zapewnia dostęp do sprzętowej kontrolki demultiplexer (selektor danych wyjściowych).
IAudioPeakMeter	Zapewnia dostęp do sprzętowej kontroli szczytowego miernika.
IAudioTreble	Zapewnia dostęp do sprzętowej kontroli na poziomie potrójnym.
IAudioVolumeLevel	Zapewnia dostęp do sprzętowego sterowania głośnością.
IConnector	Reprezentuje punkt połączenia między składnikami.
IControlInterface	Reprezentuje interfejs sterowania w części (podnit lub łącznik).
IDeviceSpecificProperty	Reprezentuje właściwość specyficzną dla urządzenia łącznika lub podnitu.
IDeviceTopology	Zapewnia dostęp do topologii urządzenia audio.
IKsFormatSupport	Zawiera informacje o formatach danych audio obsługiwanych przez połączenie we/wy skonfigurowane programowo (zazwyczaj kanał DMA) między urządzeniem audio a pamięcią systemową.
IKsJackDescription	Zawiera informacje o gniazdach lub łącznikach wewnętrznych, które zapewniają fizyczne połączenie między urządzeniem na karcie audio a zewnętrznym lub wewnętrznym urządzeniem punktu końcowego (na przykład mikrofonem lub odtwarzaczem CD).
IKsJackDescription2	Zapewnia wygodny dostęp do właściwości KSPROPERTY_JACK_DESCRIPTION2 łącznika do urządzenia punktu końcowego.
IKsJackSinkInformation	Zawiera informacje o ujściu gniazda, jeśli gniazdo jest obsługiwane przez sprzęt.
IPart	Reprezentuje część (łącznik lub podnit) topologii urządzenia.
IPartsList	Reprezentuje listę części (łączniki i podnity).
IPerChannelDbLevel	Reprezentuje ogólny interfejs sterowania modułu podrzędnego, który zapewnia kontrolę nad poziomem głośności w decybelach strumienia audio lub pasma częstotliwości w strumieniu audio.
ISubunit	Reprezentuje podnitę sprzętową (na przykład kontrolkę na poziomie woluminu), która znajduje się w ścieżce danych między klientem a urządzeniem punktu końcowego audio.
IControlChangeNotify	Dostarcza powiadomienia o zmianie stanu części (łącznika lub podnitu).

Interfejs APIvolume punktu końcowego

Interfejs API EndpointVolume umożliwia wyspecjalizowanym klientom kontrolowanie i monitorowanie poziomów głośności urządzeń punktu końcowego audio . Plik nagłówka Endpointvolume.h definiuje interfejsy w interfejsie API EndpointVolume. Aby uzyskać więcej informacji, zobacz EndpointVolume API .

W poniższej tabeli wymieniono interfejsy EndpointVolume dostępne w zestawie Core Audio SDK dla systemu Windows Vista.

interfejsu	opis
IAudioEndpointVolume	Reprezentuje kontrolki głośności strumienia audio do lub z urządzenia punktu końcowego audio.
IAudioEndpointVolumeEx	Udostępnia kontrolki głośności strumienia audio do lub z punktu końcowego urządzenia.
IAudioMeterInformation	Reprezentuje miernik szczytowy strumienia audio do lub z urządzenia punktu końcowego audio.
IAudioEndpointVolumeCallback	Dostarcza powiadomienia, gdy zmienia się poziom głośności lub stan wyciszenia urządzenia punktu końcowego audio.

Tematy pokrewne

dokumentacja programowania