Metode ISampleGrabber::SetCallback

[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

[Tidak digunakan lagi. API ini bisa dihapus dari rilis Windows mendatang.]

 

Metode SetCallback menentukan metode panggilan balik untuk memanggil sampel masuk.

Sintaks

HRESULT SetCallback(
   ISampleGrabberCB *pCallback,
   long             WhichMethodToCallback
);

Parameter

pCallback

Arahkan ke antarmuka ISampleGrabberCB yang berisi metode panggilan balik, atau NULL untuk membatalkan panggilan balik.

WhichMethodToCallback

Indeks yang menentukan metode panggilan balik. Harus salah satu dari nilai berikut.

Nilai	Deskripsi
0	Filter Sampel Grabber memanggil metode ISampleGrabberCB::SampleCB . Metode ini menerima penunjuk IMediaSample .
1	Filter Sampel Grabber memanggil metode ISampleGrabberCB::BufferCB . Metode ini menerima penunjuk ke buffer yang terkandung dalam sampel media.

 

Mengembalikan nilai

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Utas pemrosesan data memblokir hingga metode panggilan balik kembali. Jika panggilan balik tidak kembali dengan cepat, panggilan balik dapat mengganggu pemutaran.

Filter tidak memanggil fungsi panggilan balik untuk sampel pra-pendaftaran, atau untuk sampel di mana anggota dwStreamId dari struktur AM_SAMPLE2_PROPERTIES adalah apa pun selain AM_STREAM_MEDIA.

Catatan

File header Qedit.h tidak kompatibel dengan header Direct3D yang lebih baru dari versi 7.

 

Catatan

Untuk mendapatkan Qedit.h, unduh Microsoft Windows SDK Update untuk Windows Vista dan .NET Framework 3.0. Qedit.h tidak tersedia di Microsoft Windows SDK untuk Windows 7 dan .NET Framework 3.5 Service Pack 1.

 

Persyaratan

Persyaratan	Nilai
Header	Qedit.h
Pustaka	Strmiids.lib

Lihat juga

Menggunakan Sampel Grabber

Antarmuka ISampleGrabber