Bagikan melalui

Metode CDynamicOutputPin.Block

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode Block memblokir atau membuka blokir aliran data dari pin. Metode ini mengimplementasikan metode IPinFlowControl::Block .

Sintaks

HRESULT Block(
   DWORD  dwBlockFlags,
   HANDLE hEvent
);

Parameter

dwBlockFlags

Bendera yang menunjukkan apakah akan memblokir atau membuka blokir pin. Harus salah satu nilai berikut:

Nol: Buka blokir aliran data dari pin.

AM_PIN_FLOW_CONTROL_BLOCK: Memblokir aliran data dari pin.

hEvent

Menangani ke objek peristiwa, atau NULL.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang diperlihatkan dalam tabel berikut ini.

Menampilkan kode Deskripsi
S_FALSE
 Pin sudah tidak diblokir.
S_OK
 Berhasil.
E_INVALIDARG
 Argumen tidak valid.
VFW_E_PIN_ALREADY_BLOCKED
 Pin sudah diblokir pada utas lain.
VFW_E_PIN_ALREADY_BLOCKED_ON_THIS_THREAD
 Pin sudah diblokir pada utas panggilan.

Keterangan

Untuk informasi selengkapnya tentang metode ini, lihat IPinFlowControl::Block. Secara internal, metode ini memanggil salah satu metode yang dilindungi berikut:

Pembukaan blokir selalu dilakukan secara sinkron.

Persyaratan

Persyaratan Nilai
Header
Amfilter.h (termasuk Streams.h)
Pustaka
Strmbase.lib (build ritel);
Strmbasd.lib (build debug)

Lihat juga

Kelas CDynamicOutputPin