ITTerminalSupport::GetDefaultStaticTerminal method (tapi3if.h)

Artikel
03/08/2023

Metode GetDefaultStaticTerminal mendapatkan terminal statis default untuk jenis media yang ditentukan.

Sintaks

HRESULT GetDefaultStaticTerminal(
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

Parameter

[in] lMediaType

Jenis media terminal yang diperlukan.

[in] Direction

TERMINAL_DIRECTION pendeskripsi arah terminal.

[out] ppTerminal

Arahkan ke antarmuka ITTerminal . NULL jika tidak ada terminal yang tersedia.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Metode berhasil.
S_FALSE	Tidak ada terminal yang tersedia. *ppTerminal akan dikembalikan sebagai NULL.
E_FAIL	Kesalahan yang tidak ditentukan.
E_POINTER	Parameter lMediaType bukan penunjuk yang valid.
E_MEDIATYPE	Parameter lMediaType bukan jenis media yang valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk membuat objek Terminal.

Keterangan

Metode ini tidak mengembalikan terminal dinamis. Misalnya, memiliki jenis media TAPIMEDIATYPE_VIDEO dan arah terminal TD_RENDER mendefinisikan terminal dinamis; metode ini akan gagal dengan parameter tersebut.

Terminal statis default yang dikembalikan oleh metode ini adalah salah satu terminal statis yang dikembalikan oleh ITTerminalSupport::EnumerateStaticTerminals atau ITTerminalSupport::get_StaticTerminals. Biasanya, terminal default adalah terminal yang dipilih sebagai "perangkat pilihan" di applet "Suara dan Properti Multimedia" Panel Kontrol.

TAPI memanggil metode AddRef pada antarmuka ITTerminal yang dikembalikan oleh ITTerminalSupport::GetDefaultStaticTerminal. Aplikasi harus memanggil Rilis pada antarmuka ITTerminal ke sumber daya gratis yang terkait dengannya.