IMFCollection::Metode GetElement (mfobjects.h)

  • Artikel

Mengambil objek dalam koleksi.

Sintaks

HRESULT GetElement(
  [in]  DWORD    dwElementIndex,
  [out] IUnknown **ppUnkElement
);

Parameter

[in] dwElementIndex

Indeks berbasis nol dari objek yang akan diambil. Objek diindeks dalam urutan di mana objek ditambahkan ke koleksi.

[out] ppUnkElement

Menerima pointer ke antarmuka IUnknown objek. Pemanggil harus merilis antarmuka. Nilai penunjuk yang diambil mungkin NULL.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak menghapus objek dari koleksi. Untuk menghapus objek, panggil IMFCollection::RemoveElement.

Contoh

//  Gets an interface pointer from a collection (IMFCollection).
//
//  Q: Interface type

template <class Q>
HRESULT GetCollectionObject(IMFCollection *pCollection, 
    DWORD dwIndex, Q **ppObject)
{
    *ppObject = NULL;   // zero output

    IUnknown *pUnk = NULL;
    HRESULT hr = pCollection->GetElement(dwIndex, &pUnk);
    if (SUCCEEDED(hr))
    {
        hr = pUnk->QueryInterface(IID_PPV_ARGS(ppObject));
        pUnk->Release();
    }
    return hr;
}

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

IMFCollection