METODE IMFAttributes::GetItemByIndex (mfobjects.h)

  • Artikel

Mengambil atribut pada indeks yang ditentukan.

Sintaks

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

Parameter

[in] unIndex

Indeks atribut yang akan diambil. Untuk mendapatkan jumlah atribut, panggil IMFAttributes::GetCount.

[out] pguidKey

Menerima GUID yang mengidentifikasi atribut ini.

[in, out] pValue

Arahkan ke PROPVARIANT yang menerima nilai . Parameter ini bisa NULL. Jika bukan NULL, metode mengisi PROPVARIANT dengan salinan nilai atribut. Panggil PropVariantClear untuk membebaskan memori yang dialokasikan oleh metode ini.

Mengembalikan nilai

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
 Indeks tidak valid.

Keterangan

Untuk menghitung semua atribut objek dengan cara yang aman untuk utas, lakukan hal berikut:

  1. Panggil IMFAttributes::LockStore untuk mencegah utas lain menambahkan atau menghapus atribut.
  2. Panggil IMFAttributes::GetCount untuk menemukan jumlah atribut.
  3. Panggil GetItemByIndex untuk mendapatkan setiap atribut menurut indeks.
  4. Panggil IMFAttributes::UnlockStore untuk membuka kunci penyimpanan atribut.
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