Fungsi MFCreateDXSurfaceBuffer (mfapi.h)

Artikel
08/24/2023

Membuat objek buffer media yang mengelola permukaan Direct3D 9.

Sintaks

HRESULT MFCreateDXSurfaceBuffer(
  [in]  REFIID         riid,
  [in]  IUnknown       *punkSurface,
  [in]  BOOL           fBottomUpWhenLinear,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] riid

Mengidentifikasi jenis permukaan Direct3D 9. Saat ini nilai ini harus IID_IDirect3DSurface9.

[in] punkSurface

Penunjuk ke antarmuka IUnknown permukaan DirectX.

[in] fBottomUpWhenLinear

Jika TRUE, metode IMF2DBuffer::ContiguousCopyTo buffer akan menyalin buffer ke dalam format bottom-up. Format bawah ke atas kompatibel dengan GDI untuk gambar RGB yang tidak dikompresi. Jika parameter ini FALSE, metode ContiguousCopyTo menyalin buffer ke dalam format top-down, yang kompatibel dengan DirectX.

Untuk informasi selengkapnya tentang gambar top-down versus bottom-up, lihat Image Stride.

[out] ppBuffer

Menerima penunjuk ke antarmuka IMFMediaBuffer . Pemanggil harus melepaskan buffer.

Nilai kembali

Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Argumen tidak valid.

Keterangan

Fungsi ini membuat objek buffer media yang memegang pointer ke permukaan Direct3D yang ditentukan dalam punkSurface. Mengunci buffer memberi pemanggil akses ke memori permukaan. Ketika objek buffer dihancurkan, ia melepaskan permukaan. Untuk informasi selengkapnya tentang buffer media, lihat Buffer Media.

Catatan Fungsi ini tidak mengalokasikan permukaan Direct3D itu sendiri.

Objek buffer yang dibuat oleh fungsi ini juga mengekspos antarmuka IMF2DBuffer . Untuk informasi selengkapnya, lihat DirectX Surface Buffer.

Fungsi ini tidak mendukung permukaan DXGI.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfapi.h
Pustaka	Evr.lib
DLL	Evr.dll

Lihat juga

DirectX Surface Buffer

Buffer Media

Fungsi Media Foundation

Bagikan melalui