Freigeben über

IMediaPropertyBag::EnumProperty-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die EnumProperty -Methode ruft ein Eigenschafts-Wert-Paar ab.

Syntax

HRESULT EnumProperty(
  [in]      ULONG   iProperty,
  [in, out] VARIANT *pvarPropertyName,
  [in, out] VARIANT *pvarPropertyValue
);

Parameter

[in] iProperty

Indexwert des Paares.

[in, out] pvarPropertyName

Zeiger auf einen VARIANT-Wert , der den Namen der Eigenschaft empfängt.

[in, out] pvarPropertyValue

Zeiger auf einen VARIANT-Wert , der den Wert der Eigenschaft empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Ungültiges Argument.
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.
E_POINTER
 NULL-Zeigerargument.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 Index außerhalb des Bereichs.

Hinweise

Der Name ist immer eine Zeichenfolge. Legen Sie den Variant-Typ des pvarPropertyName-Parameters auf VT_EMPTY oder VT_BSTR fest, bevor Sie diese Methode aufrufen.

Der Wert kann eine Zeichenfolge (für INFO-Blöcke) oder ein Bytearray (für DISP-Blöcke) sein. Legen Sie den Variantentyp des pvarPropertyName-Parameters auf VT_EMPTY, VT_BSTR oder (VT_ARRAY | VT_UI1).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMediaPropertyBag-Schnittstelle