Metode IPinConnection::D ynamicQueryAccept (strmif.h)

[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 ini DynamicQueryAccept mengkueri apakah pin dapat menerima jenis media yang ditentukan saat grafik berjalan dengan koneksi saat ini ke pin ini.

Sintaks

HRESULT DynamicQueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

Parameter

[in] pmt

Penunjuk ke struktur AM_MEDIA_TYPE yang menentukan jenis media.

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Tipe media bisa diterima.
VFW_E_TYPE_NOT_ACCEPTED	Tipe media tidak dapat diterima.

Keterangan

Jika metode ini berhasil, pin dapat menerima jenis media pada sampel berikutnya atau dalam panggilan ke IPin::ReceiveConnection.

Aplikasi atau filter dapat memanggil metode ini untuk menentukan apakah grafik filter harus dikonfigurasi ulang. Jika pin dapat menerima jenis media yang ditentukan, tidak perlu mengonfigurasi ulang grafik.

Meskipun metode IPin::QueryAccept juga menentukan apakah pin dapat menerima jenis format, itu tidak menjamin bahwa pin dapat beralih ke format tersebut saat filter sedang berjalan. Jika Anda perlu beralih format saat filter berjalan, panggil DynamicQueryAccept sebagai gantinya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Perubahan Format Dinamis

Kode Kesalahan dan Keberhasilan

Antarmuka IPinConnection