Metodo IMFAttributes::GetItem (mfobjects.h)

Recupera il valore associato a una chiave.

Sintassi

HRESULT GetItem(
  [in]      REFGUID     guidKey,
  [in, out] PROPVARIANT *pValue
);

Parametri

[in] guidKey

GUID che identifica il valore da recuperare.

[in, out] pValue

Puntatore a un PROPVARIANT che riceve il valore. Il metodo riempie PROPVARIANT con una copia del valore archiviato, se il valore viene trovato. Chiamare PropVariantClear per liberare la memoria allocata da questo metodo. Questo parametro può essere NULL. Se questo parametro è NULL, il metodo cerca la chiave e restituisce S_OK se la chiave viene trovata, ma non copia il valore.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

Questa interfaccia è disponibile nelle piattaforme seguenti se i componenti ridistribuibili di Windows Media Format 11 SDK sono installati:

• Windows XP con Service Pack 2 (SP2) e versioni successive.
• Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) e KB925766 (aggiornamento cumulativo di ottobre 2006 per Windows XP Media Center Edition) installato.

Esempio

Nell'esempio seguente viene copiato un attributo da un archivio attributi a un altro.

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

Requisiti

Vedi anche

Attributi e proprietà

FMAttributes