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

  • Artículo

Recupera un objeto de la colección.

Sintaxis

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

Parámetros

[in] dwElementIndex

Índice de base cero del objeto que se va a recuperar. Los objetos se indexan en el orden en que se agregaron a la colección.

[out] ppUnkElement

Recibe un puntero a la interfaz IUnknown del objeto. El autor de la llamada debe liberar la interfaz . El valor del puntero recuperado podría ser NULL.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método no quita el objeto de la colección. Para quitar un objeto, llame a IMFCollection::RemoveElement.

Ejemplos

//  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 Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

IMFCollection