METODE IMFTopologyNode::ConnectOutput (mfidl.h)

Artikel
03/15/2023

Menyambungkan aliran output dari simpul ini ke aliran input simpul lain.

Sintaks

HRESULT ConnectOutput(
  [in] DWORD           dwOutputIndex,
  [in] IMFTopologyNode *pDownstreamNode,
  [in] DWORD           dwInputIndexOnDownstreamNode
);

Parameter

[in] dwOutputIndex

Indeks berbasis nol dari aliran output pada simpul ini.

[in] pDownstreamNode

Arahkan ke antarmuka IMFTopologyNode dari simpul yang akan disambungkan.

[in] dwInputIndexOnDownstreamNode

Indeks berbasis nol dari aliran input pada simpul lain.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Metode gagal.
E_INVALIDARG	Parameter tidak valid.

Keterangan

Koneksi simpul mewakili aliran data dari satu simpul ke simpul berikutnya. Aliran bersifat logis, dan ditentukan oleh indeks.

Jika simpul sudah tersambung pada output yang ditentukan, metode akan memutuskan koneksi yang ada. Jika dwOutputIndex atau dwInputIndexOnDownstreamNode menentukan aliran yang belum ada, metode menambahkan aliran sebanyak yang diperlukan.

Metode ini memeriksa kondisi tertentu yang tidak valid:

Simpul output tidak dapat memiliki koneksi output apa pun. Jika Anda memanggil metode ini pada simpul output, metode akan mengembalikan E_FAIL.
Sebuah simpul tidak dapat dihubungkan ke dirinya sendiri. Jika pDownstreamNode menentukan simpul yang sama dengan panggilan metode, metode mengembalikan E_INVALIDARG.

Namun, jika metode berhasil, itu tidak menjamin bahwa koneksi node valid. Dimungkinkan untuk membuat topologi parsial yang tidak dapat diselesaikan oleh pemuat topologi. Jika demikian, metode IMFTopoLoader::Load akan gagal.

Untuk memutuskan koneksi simpul yang ada, panggil IMFTopologyNode::D isconnectOutput.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFTopologyNode

Topologi

Bagikan melalui