Metode CDynamicOutputPin.Block

Artikel
07/28/2023

[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:

Blok (asinkron): CDynamicOutputPin::AsynchronousBlockOutputPin
Blok (sinkron): CDynamicOutputPin::SynchronousBlockOutputPin
Buka blokir: CDynamicOutputPin::UnblockOutputPin

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

Bagikan melalui