Fungsi MFCreateMediaBufferWrapper (mfapi.h)

  • Artikel

Membuat buffer media yang membungkus buffer media yang ada. Buffer media baru menunjuk ke memori yang sama dengan buffer media asli, atau ke offset dari awal memori.

Sintaks

HRESULT MFCreateMediaBufferWrapper(
  [in]  IMFMediaBuffer *pBuffer,
  [in]  DWORD          cbOffset,
  [in]  DWORD          dwLength,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] pBuffer

Penunjuk ke antarmuka IMFMediaBuffer dari buffer media asli.

[in] cbOffset

Awal buffer baru, sebagai offset dalam byte dari awal buffer asli.

[in] dwLength

Ukuran buffer baru. Nilai cbOffset + dwLength harus kurang dari atau sama dengan ukuran data valid buffer asli. (Ukuran data yang valid dikembalikan oleh metode IMFMediaBuffer::GetCurrentLength .)

[out] ppBuffer

Menerima penunjuk ke antarmuka IMFMediaBuffer . Pemanggil harus merilis antarmuka.

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
 Fungsi berhasil.
E_INVALIDARG
 Offset yang diminta atau panjang yang diminta tidak valid.

Keterangan

Ukuran maksimum buffer pembungkus terbatas pada ukuran data yang valid di buffer asli. Ini mungkin kurang dari ukuran buffer asli yang dialokasikan. Untuk mengatur ukuran data yang valid, panggil IMFMediaBuffer::SetCurrentLength.

Fungsi ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Persyaratan

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

Lihat juga

Buffer Media

Fungsi Media Foundation