IMFAttributes::GetAllocatedBlob method (mfobjects.h)

Mengambil array byte yang terkait dengan kunci. Metode ini mengalokasikan memori untuk array.

Sintaks

HRESULT GetAllocatedBlob(
  [in]  REFGUID guidKey,
  [out] UINT8   **ppBuf,
  [out] UINT32  *pcbSize
);

Parameter

[in] guidKey

GUID yang mengidentifikasi nilai mana yang akan diambil. Jenis atribut harus MF_ATTRIBUTE_BLOB.

[out] ppBuf

Jika kunci ditemukan dan nilainya adalah array byte, parameter ini menerima salinan array. Pemanggil harus membebaskan memori untuk array dengan memanggil CoTaskMemFree.

[out] pcbSize

Menerima ukuran array, dalam byte.

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.
MF_E_ATTRIBUTENOTFOUND	Kunci yang ditentukan tidak ditemukan.
MF_E_INVALIDTYPE	Nilai atribut bukan array byte.

Keterangan

Untuk menyalin nilai array byte ke dalam buffer yang dialokasikan pemanggil, gunakan metode IMFAttributes::GetBlob .

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

Atribut dan Properti

IMFAttributes

MF_ATTRIBUTE_TYPE