Zdarzenia sesji multimediów
Większość operacji sesji multimediów jest wykonywana asynchronicznie, więc aplikacja musi nasłuchiwać zdarzeń przy użyciu interfejsuIMFMediaEventGenerator sesji multimediów. (Interfejs IMFMediaSession dziedziczy IMFMediaEventGenerator.) Dokładna sekwencja zdarzeń będzie zależeć od aplikacji, ale następujące zdarzenia są wywoływane przez sesję multimediów w niemal każdej sytuacji.
| Zdarzenie | Opis |
|---|---|
| MEEndOfPresentation | Wywoływane po zakończeniu prezentacji przez źródło multimediów. Dane mogą być nadal przenoszone przez potok w tej chwili. |
| MEError | Zgłaszane, jeśli podczas przesyłania strumieniowego wystąpi błąd. |
| MESessionClosed | Podniesione po zakończeniu metody Close. To zdarzenie jest ostatnim zdarzeniem, które kolejkuje sesja multimediów. Po otrzymaniu tego zdarzenia można bezpiecznie zamknąć wszystkie utworzone źródła multimediów. |
| MESessionEnded | Wywoływane po zakończeniu sesji multimediów z ostatnią prezentacją. |
| MESessionNotifyPresentationTime | Powiadamia aplikację czasu prezentacji, kiedy rozpocznie się nowa prezentacja. |
| MESessionStarted | Podniesione po zakończeniu metody Start. O ile nie wystąpi błąd, dane przechodzą przez potok w tym momencie. |
| MESessionTopologySet | Podniesione po zakończeniu metody settopology. Jeśli nie wystąpi błąd, aplikacja nie musi podejmować żadnych działań. |
| MESessionTopologyStatus | Podniesione w różnych momentach zmiany stanu topologii. |
Metoda IMFMediaSession::Shutdown nie zgłasza zdarzenia. Metoda Shutdown jest synchroniczna. Po powrocie tej metody można bezpiecznie zwolnić wskaźnik wywołania zwrotnego zdarzeń.
Oprócz zdarzeń z sesji multimediów aplikacja może odbierać zdarzenia z ujścia multimediów w topologii. Mogą to być zdarzenia niestandardowe zdefiniowane przez ujście multimediów, które mogą zawierać dowolne dane. Na przykład ujście może pochodzić dane zdarzenia z danych źródłowych, które mogą pochodzić z niezaufanego źródła zewnętrznego. Aplikacja powinna ignorować wszystkie zdarzenia, których nie rozpoznaje, i zachować ostrożność podczas analizowania danych zdarzeń.
Tematy pokrewne