Compartilhar via


Método IMFCollection::GetElement (mfobjects.h)

Recupera um objeto na coleção.

Sintaxe

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

Parâmetros

[in] dwElementIndex

Índice baseado em zero do objeto a ser recuperado. Os objetos são indexados na ordem em que foram adicionados à coleção.

[out] ppUnkElement

Recebe um ponteiro para a interface IUnknown do objeto. O chamador deve liberar a interface. O valor do ponteiro recuperado pode ser NULL.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método não remove o objeto da coleção. Para remover um objeto, chame IMFCollection::RemoveElement.

Exemplos

//  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;
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFCollection