IMFSourceReaderEx::SetNativeMediaType-Methode (mfreadwrite.h)

Artikel
08/24/2023

Legt den nativen Medientyp für einen Stream für die Medienquelle fest.

Syntax

HRESULT SetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  IMFMediaType *pMediaType,
  [out] DWORD        *pdwStreamFlags
);

Parameter

[in] dwStreamIndex

[in] pMediaType

Ein Zeiger auf die IMFMediaType-Schnittstelle des Medientyps.

[out] pdwStreamFlags

Empfängt einen bitweisen OR mit 0 oder mehr der folgenden Flags.

Wert	Bedeutung
MF_SOURCE_READERF_ALLEFFECTSREMOVED	Alle Effekte wurden aus dem Stream entfernt.
MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED	Der aktuelle Ausgabetyp wurde geändert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
MF_E_INVALIDREQUEST	Ungültige Anforderung.
MF_E_INVALIDSTREAMNUMBER	Der dwStreamIndex-Parameter ist ungültig.

Hinweise

Diese Methode legt den Ausgabetyp fest, der von der Medienquelle erzeugt wird. Im Gegensatz zur IMFSourceReader::SetCurrentMediaType-Methode fügt diese Methode keine Decoder, Videoprozessoren oder andere Transformationen ein. Die Medienquelle muss den angegebenen Medientyp nativ unterstützen. Um eine Liste der unterstützten Typen aus der Medienquelle abzurufen, rufen Sie IMFSourceReader::GetNativeMediaType auf.

Im asynchronen Modus schlägt diese Methode fehl, wenn eine Beispielanforderung aussteht. Warten Sie in diesem Fall, bis der OnReadSample-Rückruf aufgerufen wird, bevor Sie die -Methode aufrufen. Weitere Informationen zur Verwendung des Quelllesers im asynchronen Modus finden Sie unter IMFSourceReader::ReadSample.

Diese Methode kann eine Änderung des Ausgabeformats für den Stream auslösen. Wenn ja, wird das MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED-Flag im pdwStreamFlags-Parameter zurückgegeben. Die Methode kann auch dazu führen, dass der Quellleser alle Effekte entfernt, die von der IMFSourceReaderEx::AddTransformForStream-Methode hinzugefügt wurden. In diesem Fall wird das MF_SOURCE_READERF_ALLEFFECTSREMOVED-Flag in pdwStreamFlags zurückgegeben.

Diese Methode ist bei Audio- und Videoaufnahmegeräten nützlich, da ein Gerät möglicherweise mehrere Ausgabeformate unterstützt. Mit dieser Methode kann die Anwendung das Geräteformat auswählen, bevor Decoder und andere Transformationen hinzugefügt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfreadwrite.h

Weitere Informationen

IMFSourceReaderEx

Freigeben über