IMFSourceReader::GetNativeMediaType-Methode (mfreadwrite.h)
Ruft ein Format ab, das von der Medienquelle nativ unterstützt wird.
Syntax
HRESULT GetNativeMediaType(
[in] DWORD dwStreamIndex,
[in] DWORD dwMediaTypeIndex,
[out] IMFMediaType **ppMediaType
);
Parameter
[in] dwStreamIndex
Gibt den abzufragenden Stream an. Der Wert kann einer der folgenden Werte sein.
[in] dwMediaTypeIndex
Gibt an, welcher Medientyp abfragt werden soll. Der Wert kann einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Der nullbasierte Index eines Medientyps |
|
Der aktuelle native 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ögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
Rückgabecode | Beschreibung |
---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der dwStreamIndex-Parameter ist ungültig. |
|
Der dwMediaTypeIndex-Parameter liegt außerhalb des Bereichs. |
Hinweise
Diese Methode fragt die zugrunde liegende Medienquelle nach ihrem nativen Ausgabeformat ab. Potenziell kann jeder Quellstream 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 Stream, aber Aufzeichnungsgeräte bieten möglicherweise mehrere Formate.
Die -Methode gibt eine Kopie des Medientyps zurück, sodass es sicher ist, das im ppMediaType-Parameter empfangene Objekt zu ändern.
Um den Ausgabetyp für einen Stream festzulegen, rufen Sie die IMFSourceReader::SetCurrentMediaType-Methode auf.
Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | mfreadwrite.h |