ITTerminalManager::CreateDynamicTerminal method (termmgr.h)

Artikel
07/16/2024

Metode CreateDynamicTerminal membuat terminal dinamis dari kelas terminal, jenis media, dan arah tertentu.

Sintaksis

HRESULT CreateDynamicTerminal(
  [in]  IUnknown           *pOuterUnknown,
  [in]  IID                iidTerminalClass,
  [in]  DWORD              dwMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [in]  MSP_HANDLE         htAddress,
  [out] ITTerminal         **ppTerminal
);

Parameter

[in] pOuterUnknown

Jika MSP akan mengagregasi objek terminal, atur ke penunjuk antarmuka IUnknown untuk objek MSP. Biasanya ini diatur ke null.

[in] iidTerminalClass

GUID mengidentifikasi kelas terminal yang akan dibuat.

[in] dwMediaType

Deskriptor jenis media untuk aliran.

[in] Direction

TERMINAL_DIRECTION pendeskripsi arah aliran media untuk terminal.

[in] htAddress

Handel MSP.

[out] ppTerminal

Penunjuk ke antarmuka ITTerminal untuk terminal baru.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Arti
S_OK	Metode berhasil.
E_INVALIDARG	Parameter fMessageWaiting tidak valid.
E_POINTER	Parameter ppAddress bukan penunjuk yang valid.

Komentar

Saat memilih nilai untuk pTerminalClass, satu-satunya GUID kelas terminal yang dapat digunakan adalah yang sesuai dengan terminal yang "dibuat secara dinamis". Misalnya, dari semua kelas terminal yang saat ini ditentukan oleh TAPI3, hanya berikut ini yang dapat digunakan dengan CreateTerminal: CLSID_MediaStreamTerminal dan CLSID_VideoWindowTerm.

Selain itu, hanya kelas terminal dinamis yang didukung pada alamat ini yang dapat digunakan. Aplikasi dapat menemukan nilai-nilai ini dengan menggunakan ITTerminalSupport::EnumerateDynamicTerminalClasses atau ITTerminalSupport::get_DynamicTerminalClasses.

Aplikasi harus mendapatkan pTerminalClassBSTR dalam dua langkah: panggil StringFromIID untuk mengonversi GUID keLPOLESTR , lalu panggil SysAllocString untuk mengonversi LPOLESTR ke BSTR.

Aplikasi harus menggunakan SysFreeString untuk membebaskan memori yang dialokasikan untuk parameter pTerminalClass .

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	termmgr.h

Lihat juga

ITTerminalManager

TERMINAL_DIRECTION

jenis media

Bagikan melalui