IMFAttributes::GetItemByIndex-Methode (mfobjects.h)

  • Artikel

Ruft ein Attribut am angegebenen Index ab.

Syntax

HRESULT GetItemByIndex(
  [in]      UINT32      unIndex,
  [out]     GUID        *pguidKey,
  [in, out] PROPVARIANT *pValue
);

Parameter

[in] unIndex

Index des abzurufenden Attributs. Um die Anzahl der Attribute abzurufen, rufen Sie IMFAttributes::GetCount auf.

[out] pguidKey

Empfängt die GUID, die dieses Attribut identifiziert.

[in, out] pValue

Zeiger auf einen PROPVARIANT,der den Wert empfängt. Dieser Parameter kann NULL sein. Wenn es nicht NULL ist, füllt die Methode PROPVARIANT mit einer Kopie des Attributwerts aus. Rufen Sie PropVariantClear auf, um den von dieser Methode zugewiesenen Arbeitsspeicher freizugeben.

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.
E_INVALIDARG
 Ungültiger Index.

Hinweise

Gehen Sie wie folgt vor, um alle Attribute eines Objekts threadsicher aufzulisten:

  1. Rufen Sie IMFAttributes::LockStore auf, um zu verhindern, dass ein anderer Thread Attribute hinzufügt oder löscht.
  2. Rufen Sie IMFAttributes::GetCount auf, um die Anzahl der Attribute zu ermitteln.
  3. Rufen Sie GetItemByIndex auf, um jedes Attribut nach Index abzurufen.
  4. Rufen Sie IMFAttributes::UnlockStore auf, um den Attributspeicher zu entsperren.
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.

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