IMFAttributes::GetItem-Methode (mfobjects.h)

Artikel
03/01/2024

Ruft den einem Schlüssel zugeordneten Wert ab.

Syntax

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

Parameter

[in] guidKey

Eine GUID, die den abzurufenden Wert identifiziert.

[in, out] pValue

Ein Zeiger auf eine PROPVARIANT,die den Wert empfängt. Die -Methode füllt propVARIANT mit einer Kopie des gespeicherten Werts auf, wenn der Wert gefunden wird. Rufen Sie PropVariantClear auf, um den von dieser Methode zugewiesenen Arbeitsspeicher freizugeben. Dieser Parameter kann NULL sein. Wenn dieser Parameter NULL ist, sucht die Methode nach dem Schlüssel und gibt S_OK zurück, wenn der Schlüssel gefunden wird, kopiert den Wert jedoch nicht.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_ATTRIBUTENOTFOUND	Der angegebene Schlüssel wurde nicht gefunden.

Hinweise

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

Windows XP mit Service Pack 2 (SP2) und höher.
Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Beispiele

Im folgenden Beispiel wird ein Attribut aus einem Attributspeicher in einen anderen kopiert.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfobjects.h (include Mfidl.h)
Bibliothek	Mfuuid.lib

Weitere Informationen

Attribute und Eigenschaften

IMFAttributes

Freigeben über