IMFSourceReaderEx::SetNativeMediaType-Methode (mfreadwrite.h)

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.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

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

Weitere Informationen

IMFSourceReaderEx