ITStream::SelectTerminal method (tapi3if.h)

Metode SelectTerminal memilih objek ITTerminal ke aliran.

Sintaks

HRESULT SelectTerminal(
  [in] ITTerminal *pTerminal
);

Parameter

[in] pTerminal

Penunjuk ke antarmuka ITTerminal dari terminal yang dipilih.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Parameter pTerminal bukan penunjuk yang valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.
TAPI_E_MAXTERMINALS	Beberapa terminal telah dipilih pada aliran, tetapi pencampuran atau pemisahan media tidak dimungkinkan.
TAPI_E_INVALIDTERMINAL	Terminal yang dipilih tidak valid.

Keterangan

Terminal dapat dipilih kapan saja, terlepas dari apakah transportasi dalam keadaan yang memungkinkannya mengalirkan media. Jika transportasi dalam keadaan yang memungkinkannya mengalirkan media, dan aplikasi belum berhasil memanggil ITStream::P auseStream atau ITStream::StopStream pada aliran, atau telah berhasil memanggil ITStream::StartStream untuk aliran ini lebih baru daripada yang berhasil dipanggil ITStream::P auseStream atau ITStream::StopStream untuk aliran ini, maka streaming dimulai secara otomatis segera setelah terminal dipilih. Jika terminal dipilih pada aliran sebelum transportasi memasuki status di mana ia dapat mengalirkan media, dan tidak ada panggilan berikutnya ke StopStream atau PauseStream yang dilakukan, maka aliran dimulai secara otomatis ketika transportasi memasuki status di mana ia dapat mengalirkan media.

Peristiwa CME_STREAM_ACTIVE dihasilkan ketika streaming benar-benar dimulai, yang mungkin lebih lambat dari panggilan SelectTerminal . Peristiwa CME_STREAM_FAIL atau CME_TERMINAL_FAIL dihasilkan ketika streaming benar-benar gagal, yang mungkin juga lebih lambat dari panggilan SelectTerminal .

Terminal dapat dipilih ke aliran hanya jika hasil ITTerminal::get_MediaType cocok dengan ITStream::get_MediaType. Selain itu, beberapa MSP mungkin memerlukan kecocokan antara ITTerminal::get_Direction dan ITStream::get_Direction, meskipun antarmuka tidak memberlakukan ini.

Beberapa MSP mungkin tidak mengizinkan lebih dari sejumlah terminal tertentu, biasanya satu, untuk dipilih secara bersamaan pada aliran yang sama, tetapi antarmuka itu sendiri tidak memberlakukan pembatasan tersebut. Memilih beberapa terminal sekaligus pada aliran yang sama berguna, misalnya, untuk memungkinkan perekaman aliran audio masuk ke file sambil mendengarkan aliran pada sepasang speaker.

Terminal tertentu hanya dapat dipilih ke satu aliran.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi3if.h (termasuk Tapi3.h)

Lihat juga

ITStream

Antarmuka Penyedia Layanan Media (MSPI)