IGraphConfig::Metode konfigurasi ulang (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.]

Metode ini Reconfigure mengunci grafik filter dan memanggil fungsi panggilan balik dalam aplikasi atau filter untuk melakukan konfigurasi ulang dinamis.

Sintaks

HRESULT Reconfigure(
  [in] IGraphConfigCallback *pCallback,
  [in] PVOID                pvContext,
  [in] DWORD                dwFlags,
  [in] HANDLE               hAbortEvent
);

Parameter

[in] pCallback

Arahkan ke antarmuka panggilan balik IGraphConfigCallback pada aplikasi atau filter.

[in] pvContext

Penunjuk ke variabel jenis PVOID yang diteruskan ke rutinitas panggilan balik.

[in] dwFlags

Bendera yang ditentukan aplikasi yang diteruskan ke rutinitas panggilan balik.

[in] hAbortEvent

Menangani ke peristiwa. Jika pemanggil adalah panggilan filter pada salah satu utas pemrosesan datanya, parameter ini harus menjadi handel ke peristiwa yang akan diberi sinyal ketika filter dimasukkan ke dalam status berhenti. Jika tidak, parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

Mengembalikan S_OK jika berhasil, atau kode kesalahan sebaliknya. Kemungkinan kesalahan termasuk VFW_E_WRONG_STATE, jika metode tidak dapat memperoleh kunci pada grafik filter; HRESULT apa pun yang dikembalikan oleh rutinitas panggilan balik; atau kode kesalahan yang menunjukkan bahwa grafik tidak dapat menempatkan filter ke dalam status berjalan.

Keterangan

Metode ini disediakan sehingga aplikasi atau filter dapat mengimplementasikan bangunan grafik dinamis khusus. Namun, dalam kebanyakan kasus, metode IGraphConfig::Reconnect memadai, dan harus lebih disukai karena menangani sebagian besar detail implementasi.

Sebelum memanggil metode ini, blokir aliran apa pun sesuai kebutuhan dan dorong data melalui grafik (lihat IPinFlowControl::Block dan IGraphConfig::P ushThroughData). Jika metode panggilan balik berhasil, IGraphConfig::Reconfigure upaya untuk menempatkan semua filter ke dalam status berjalan. (Pemanggil kemudian harus membuka blokir aliran data.) Jika tidak, ia mengembalikan kode kesalahan apa pun yang dikembalikan metode panggilan balik.

Jika filter memanggil metode ini pada salah satu utas pemrosesan datanya sendiri, filter akan menciptakan potensi kebuntuan. Metode ini mendapatkan kunci pada grafik filter, yang dapat memblokir filter agar tidak berhenti menerima panggilan ke IMediaFilter::Stop. Untuk mencegah situasi ini, metode mengambil handel ke objek peristiwa yang disediakan oleh filter. Filter harus memberi sinyal peristiwa jika menerima panggilan ke metode Stop-nya .

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

Kode Kesalahan dan Keberhasilan

Antarmuka IGraphConfig

Bagikan melalui