ITStreamControl::Metode CreateStream (tapi3if.h)

Artikel
08/26/2023

Metode CreateStream membuat aliran media baru.

Sintaks

HRESULT CreateStream(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION td,
  [out] ITStream           **ppStream
);

Parameter

[in] lMediaType

Menunjukkan jenis media untuk streaming.

[in] td

Menunjukkan TERMINAL_DIRECTION.

[out] ppStream

Penunjuk ke penunjuk untuk antarmuka ITStream yang baru dibuat.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
E_POINTER	Parameter ppStream bukan penunjuk yang valid.
E_OUTOFMEMORY	Memori tidak cukup ada untuk melakukan operasi.
TAPI_E_INVALIDMEDIATYPE	Parameter lMediaType bukan tipe media yang valid.
TAPI_E_INVALIDDIRECTION	Parameter td bukan arah terminal yang valid.
TAPI_E_MAXSTREAMS	Jumlah maksimum aliran yang didukung telah tercapai.
TAPI_E_NOTSUPPORTED	Operasi ini tidak didukung.

Keterangan

Banyak MSP tidak mendukung pembuatan aliran yang dinamis, dan hanya mengembalikan TAPI_E_MAXSTREAMS dalam implementasi metode ini. Aliran default tersedia secara otomatis saat panggilan dibuat, sehingga sebagian besar aplikasi tidak perlu menggunakan metode ini.

Pembuatan atau penghapusan streaming mungkin melibatkan interaksi dengan titik akhir jarak jauh, menghasilkan CMC_REMOTE_REQUEST daripada pesan CMC_LOCAL_REQUEST yang diterima saat streaming dihentikan atau dimulai.

TAPI memanggil metode AddRef pada antarmuka ITStream yang dikembalikan oleh ITStreamControl::CreateStream. Aplikasi harus memanggil Rilis pada antarmuka ITStream ke sumber daya gratis yang terkait dengannya.