IMediaFilter::Metode GetState (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 GetState mengambil status filter (berjalan, dihentikan, atau dijeda).
Sintaks
HRESULT GetState(
[in] DWORD dwMilliSecsTimeout,
[out] FILTER_STATE *State
);
Parameter
[in] dwMilliSecsTimeout
Interval waktu habis, dalam milidetik. Untuk memblokir tanpa batas waktu, gunakan nilai INFINITE.
[out] State
Menerima anggota jenis FILTER_STATE yang dijumlahkan, menunjukkan status filter.
Mengembalikan nilai
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang diperlihatkan dalam tabel berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Argumen penunjuk NULL. |
|
Negara perantara. |
|
Filter aktif, tetapi tidak dapat mengirimkan data. |
Keterangan
Transisi status bisa asinkron. Jika filter beralih ke status baru, dan metode kehabisan waktu sebelum transisi selesai, metode mengembalikan VFW_S_STATE_INTERMEDIATE.
Jika filter tidak dapat mengirimkan data karena alasan tertentu, filter akan mengembalikan VFW_S_CANT_CUE. Filter penangkapan langsung mengembalikan nilai ini saat dijeda, karena tidak mengirimkan data dalam status dijeda.
Untuk informasi selengkapnya, lihat Aliran Data di Grafik Filter.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | strmif.h (termasuk Dshow.h) |
Pustaka | Strmiids.lib |