Metode IMediaDet::WriteBitmapBits

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

Catatan

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

 

Metode ini WriteBitmapBits mengambil bingkai video pada waktu media yang ditentukan dan menulisnya ke file. Bingkai video selalu dalam format RGB 24-bit.

Sintaks

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

Parameter

StreamTime

Waktu untuk mengambil bingkai video.

Lebar

Lebar gambar, dalam piksel.

Tinggi

Tinggi gambar, dalam piksel.

Filename

Jalur file untuk menyimpan bitmap. Jika file sudah ada, metode ini akan menimpanya.

Mengembalikan nilai

Mengembalikan S_OK berhasil. Jika tidak, mengembalikan nilai HRESULT yang menunjukkan penyebab kesalahan. Kemungkinan kode kesalahan meliputi yang berikut ini:

Menampilkan kode	Deskripsi
E_NOINTERFACE	Tidak dapat menambahkan filter Sampel Grabber ke grafik.
E_FAIL	Kegagalan.
E_OUTOFMEMORY	Memori tidak cukup.
E_UNEXPECTED	Kesalahan tak terduga.
STG_E_ACCESSDENIED	Tidak dapat menimpa file.
VFW_E_INVALIDMEDIATYPE	Tipe media tidak valid.

 

Keterangan

Sebelum memanggil metode ini, atur nama file dan streaming dengan memanggil IMediaDet::p ut_Filename dan IMediaDet::p ut_CurrentStream.

Metode ini menempatkan detektor media ke dalam mode ambil bitmap. Setelah metode ini dipanggil, berbagai metode informasi aliran di IMediaDet tidak berfungsi, kecuali Anda membuat instans baru detektor media.

Catatan

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

 

Catatan

Untuk mendapatkan Qedit.h, unduh Pembaruan SDK Microsoft Windows untuk Windows Vista dan .NET Framework 3.0. Qedit.h tidak tersedia di Microsoft Windows SDK untuk Windows 7 dan .NET Framework 3.5 Paket Layanan 1.

 

Persyaratan

Persyaratan	Nilai
Header	Qedit.h
Pustaka	Strmiids.lib

Lihat juga

Antarmuka IMediaDet

Kode Kesalahan dan Keberhasilan