ICaptureGraphBuilder::Metode ControlStream (strmif.h)

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.]

Catatan Antarmuka ICaptureGraphBuilder tidak digunakan lagi. Gunakan ICaptureGraphBuilder2 sebagai gantinya.

Mengirim pesan kontrol aliran ke pin kategori yang ditentukan pada satu atau beberapa filter pengambilan dalam grafik.

Sintaks

HRESULT ControlStream(
  [in] const GUID     *pCategory,
  [in] IBaseFilter    *pFilter,
  [in] REFERENCE_TIME *pstart,
  [in] REFERENCE_TIME *pstop,
  [in] WORD           wStartCookie,
  [in] WORD           wStopCookie
);

Parameter

[in] pCategory

Pointer ke GUID yang menentukan kategori pin output. Lihat Menyematkan Kumpulan Properti untuk daftar semua kategori pin. Nilai ini tidak boleh NULL.

[in] pFilter

Arahkan ke antarmuka IBaseFilter pada filter untuk dikontrol. Menentukan NULL mengontrol semua filter pengambilan dalam grafik. Anda akan mendapatkan satu pemberitahuan untuk setiap filter pengambilan.

[in] pstart

Arahkan ke waktu mulai untuk mengambil. NULL berarti mulai sekarang. MAX_TIME berarti membatalkan permintaan sebelumnya, atau tidak mengambil tindakan jika tidak ada permintaan sebelumnya.

[in] pstop

Arahkan ke waktu berhenti untuk mengambil. NULL berarti berhenti sekarang. MAX_TIME berarti membatalkan permintaan sebelumnya, atau tidak mengambil tindakan jika tidak ada permintaan sebelumnya.

[in] wStartCookie

Menentukan nilai tertentu yang akan dikirim ketika awal terjadi.

[in] wStopCookie

Menentukan nilai tertentu yang akan dikirim ketika pemberhentian terjadi.

Mengembalikan nilai

Mengembalikan S_FALSE jika pemberitahuan berhenti dikirim sebelum sampel terakhir yang dikirim oleh filter pengambilan dirender, jika tidak, mengembalikan S_OK.

Jika metode ini mengembalikan S_FALSE, aplikasi mungkin ingin menunggu sebelum menghentikan grafik filter untuk memungkinkan semua sampel melewati grafik dan dirender. Jika tidak, sampel mungkin hilang.

Jika tidak ada pin yang cocok dengan deskripsi yang Anda berikan, atau jika kontrol aliran tidak dapat didukung pada semua pin yang ditunjukkan, fungsi ini akan mengembalikan kode kegagalan.

Keterangan

Gunakan metode ini untuk pengambilan yang akurat bingkai, atau untuk kontrol individu atas penangkapan dan pratinjau. Misalnya, Anda dapat menonaktifkan penulisan gambar yang diambil ke disk jika Anda hanya ingin mempratinjau gambar yang diambil.

Metode ini menggunakan antarmuka IAMStreamControl pada pin.

Metode ini mengirimkan satu pemberitahuan untuk setiap filter yang ditemukan dengan pin kategori yang ditentukan.

Persyaratan


Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka ICaptureGraphBuilder

Bagikan melalui