Uzyskiwanie punktu końcowego urządzenia na potrzeby routingu strumienia

W systemie Windows 7 interfejsy API platformy wysokiego poziomu korzystające z podstawowych interfejsów API audio, takich jak Media Foundation, DirectSound i Wave API, implementują funkcję routingu strumienia, obsługując przełączanie strumienia z istniejącego urządzenia do nowego domyślnego punktu końcowego audio. Aplikacje multimedialne korzystające z tych API (na przykład aplikacja uaktywniająca obiekt IDirectSound lub IBaseFilter na obiekcie IMMDevice) korzystają z routingu strumienia bez żadnych modyfikacji źródła.

Interfejsy API wysokiego poziomu implementują trasowanie strumienia dla punktu końcowego urządzenia uzyskanego za pośrednictwem IMMDeviceEnumerator::GetDefaultAudioEndpoint. Jeśli aplikacja przesyła strumieniowo do urządzenia domyślnego, funkcja routingu strumienia działa zgodnie z określeniem. Strumienie nie są przełączane na nowe urządzenie, jeśli są pobierane przez jakikolwiek inny mechanizm, nawet jeśli jest on taki sam jak urządzenie domyślne.

Aplikacja multimediów korzystająca bezpośrednio z podstawowych interfejsów API audio (klient WASAPI) może zapewnić niestandardową implementację routingu strumienia dla dowolnego urządzenia renderowania lub przechwytywania. Klient WASAPI może replikować implementację dostarczaną przez interfejsy API wysokiego poziomu, ograniczając je do strumieni otwartych na urządzeniach ustawionych jako urządzenie domyślne. Aby uzyskać odwołanie do domyślnego punktu końcowego urządzenia, klient musi wywołać IMMDeviceEnumerator::GetDefaultAudioEndpoint. W tym wywołaniu klient musi wskazać, czy wymaga wskaźnika do urządzenia domyślnego renderowania, czy domyślnego urządzenia przechwytywania, określając parametr dataFlow. Klient musi również określić odpowiednią rolę dla punktu końcowego w atrybucie ERole (eConsole lub eCommunications). Nie używaj eMultimedia.

Jeśli aplikacja przesyła strumieniowo do dowolnego innego urządzenia, aplikacja może pobrać urządzenie, określając ciąg identyfikatora punktu końcowego (wywołując IMMDeviceEnumerator::GetDevice).

Po zidentyfikowaniu urządzenia klient WASAPI może zapewnić implementację routingu strumienia, obsługując powiadomienia dotyczące sesji urządzenia i audio wysyłane dla urządzenia. Aby uzyskać więcej informacji na temat tych powiadomień, zobacz Istotne powiadomienia dotyczące routingu strumienia.

Tematy pokrewne

Informacje o API MMDevice

o WASAPI

Strumieniowanie routingu