IMFMediaTypeHandler::GetMediaTypeByIndex-Methode (mfidl.h)

Ruft einen Medientyp aus der Liste der unterstützten Medientypen des Objekts ab.

Syntax

HRESULT GetMediaTypeByIndex(
  [in]  DWORD        dwIndex,
  [out] IMFMediaType **ppType
);

Parameter

[in] dwIndex

Nullbasierter Index des abzurufenden Medientyps. Um die Anzahl der Medientypen in der Liste abzurufen, rufen Sie IMFMediaTypeHandler::GetMediaTypeCount auf.

[out] ppType

Empfängt einen Zeiger auf die IMFMediaType-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

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_NO_MORE_TYPES
Der dwIndex-Parameter liegt außerhalb des Bereichs.

Hinweise

Medientypen werden in der ungefähren Reihenfolge der Einstellung zurückgegeben. Die Liste der unterstützten Typen ist nicht garantiert vollständig. Um zu testen, ob ein bestimmter Medientyp unterstützt wird, rufen Sie IMFMediaTypeHandler::IsMediaTypeSupported auf.

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

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaTypeHandler