Share via

METODE IMFTopologyNode::ConnectOutput (mfidl.h)

  • Artikel

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