METODE IMFSample::GetBufferByIndex (mfobjects.h)

Artikel
02/28/2024

Mendapatkan buffer dari sampel, menurut indeks.

Catatan Dalam kebanyakan kasus, lebih aman untuk menggunakan metode IMFSample::ConvertToContiguousBuffer . Jika sampel berisi lebih dari satu buffer, metode ConvertToContiguousBuffer menggantinya dengan satu buffer, menyalin data asli ke dalam buffer tersebut, dan mengembalikan buffer baru ke pemanggil. Operasi salin terjadi paling banyak sekali. Pada panggilan berikutnya, tidak ada data yang disalin.

Sintaks

HRESULT GetBufferByIndex(
  [in]  DWORD          dwIndex,
  [out] IMFMediaBuffer **ppBuffer
);

Parameter

[in] dwIndex

Indeks buffer. Untuk menemukan jumlah buffer dalam sampel, panggil IMFSample::GetBufferCount. Buffer diindeks dari nol.

[out] ppBuffer

Menerima penunjuk ke antarmuka IMFMediaBuffer . Pemanggil harus merilis antarmuka.

Nilai kembali

Metode 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 pointer NULL, atau indeks di luar rentang.

Keterangan

Sampel mungkin berisi lebih dari satu buffer. Gunakan metode GetBufferByIndex untuk menghitung buffer individual.

Antarmuka 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	mfobjects.h (termasuk Mfidl.h)
Pustaka	Mfuuid.lib

Lihat juga

IMFSample

IMFSample::ConvertToContiguousBuffer

Sampel Media

Bagikan melalui