Metodo IMFCollection::GetElement (mfobjects.h)
Recupera un oggetto nell'insieme.
Sintassi
HRESULT GetElement(
[in] DWORD dwElementIndex,
[out] IUnknown **ppUnkElement
);
Parametri
[in] dwElementIndex
Indice in base zero dell'oggetto da recuperare. Gli oggetti vengono indicizzati nell'ordine in cui sono stati aggiunti all'insieme.
[out] ppUnkElement
Riceve un puntatore all'interfaccia IUnknown dell'oggetto. Il chiamante deve rilasciare l'interfaccia. Il valore del puntatore recuperato potrebbe essere NULL.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Questo metodo non rimuove l'oggetto dall'insieme. Per rimuovere un oggetto, chiamare FMCollection::RemoveElement.
Esempio
// 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;
}
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [app desktop | App UWP] |
Server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | mfobjects.h (include Mfidl.h) |
Libreria | Mfuuid.lib |