Freigeben über

IMFSourceReader::GetNativeMediaType-Methode (mfreadwrite.h)

Ruft ein Format ab, das nativ von der Medienquelle unterstützt wird.

Syntax

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Die Parameter

[in] dwStreamIndex

Gibt an, welcher Datenstrom abfragt werden soll. Der Wert kann eine der folgenden Sein:

Wert Bedeutung
0–0xFFFFFFFB
 Der nullbasierte Index eines Datenstroms.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 Der erste Audiodatenstrom.

[in] dwMediaTypeIndex

Gibt an, welcher Medientyp abfragt werden soll. Der Wert kann eine der folgenden Sein:

Wert Bedeutung
0–0xFFFFFFFE
 Der nullbasierte Index eines Medientyps
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
 Der aktuelle systemeigene Medientyp.

[out] ppMediaType

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

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode Description
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDSTREAMNUMBER
 Der dwStreamIndex-Parameter ist ungültig.
MF_E_NO_MORE_TYPES
 Der dwMediaTypeIndex-Parameter liegt außerhalb des Bereichs.

Bemerkungen

Diese Methode fragt die zugrunde liegende Medienquelle für das systemeigene Ausgabeformat ab. Potenziell kann jeder Quelldatenstrom mehr als ein Ausgabeformat erzeugen. Verwenden Sie den dwMediaTypeIndex-Parameter , um die verfügbaren Formate zu durchlaufen. Im Allgemeinen bieten Dateiquellen nur ein Format pro Datenstrom, aber Aufnahmegeräte bieten möglicherweise mehrere Formate an.

Die Methode gibt eine Kopie des Medientyps zurück, sodass es sicher ist, das im ppMediaType-Parameter empfangene Objekt zu ändern.

Rufen Sie zum Festlegen des Ausgabetyps für einen Datenstrom die IMFSourceReader::SetCurrentMediaType-Methode auf.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdate-Ergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Ergänzung zu Windows 7, Windows Vista und Platform Update für Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header mfreadwrite.h

Siehe auch

IMFSourceReader-

Quellleser

  • Last updated on