METODE IMFMediaEngine::TransferVideoFrame (mfmediaengine.h)

Menyalin bingkai video saat ini ke permukaan DXGI atau bitmap WIC.

Sintaks

HRESULT TransferVideoFrame(
  [in] IUnknown                    *pDstSurf,
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parameter

[in] pDstSurf

Penunjuk ke antarmuka IUnknown dari permukaan tujuan.

[in] pSrc

Penunjuk ke struktur MFVideoNormalizedRect yang menentukan persegi panjang sumber.

[in] pDst

Penunjuk ke struktur RECT yang menentukan persegi panjang tujuan.

[in] pBorderClr

Penunjuk ke struktur MFARGB yang menentukan warna batas.

Nilai kembali

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

Keterangan

Dalam mode frame-server, panggil metode ini untuk mem-blit bingkai video ke permukaan DXGI atau WIC. Aplikasi dapat memanggil metode ini kapan saja setelah Mesin Media memuat sumber daya video. Namun, biasanya, aplikasi memanggil IMFMediaEngine::OnVideoStreamTick terlebih dahulu, untuk menentukan apakah bingkai baru tersedia. Jika OnVideoStreamTick mengembalikan S_OK, aplikasi kemudian memanggil TransferVideoFrame.

Media Engine menskalakan dan kotak surat video agar pas dengan persegi panjang tujuan. Ini mengisi area kotak surat dengan warna batas.

Untuk konten yang dilindungi, panggil metode IMFMediaEngineProtectedContent::TransferVideoFrame alih-alih metode ini.

Persyaratan

Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	mfmediaengine.h

Lihat juga

IMFMediaEngine