Share via

IMFSourceReaderEx::SetNativeMediaType-Methode (mfreadwrite.h)

  • Artikel

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