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.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_ATTRIBUTENOTFOUND	La chiave specificata non è stata trovata.

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

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

Vedi anche

Attributi e proprietà

FMAttributes