IMFSourceReaderEx::GetTransformForStream-Methode (mfreadwrite.h)

  • Artikel

Ruft einen Zeiger auf eine Media Foundation-Transformation (MFT) für einen angegebenen Stream ab.

Syntax

HRESULT GetTransformForStream(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwTransformIndex,
  [out] GUID         *pGuidCategory,
  [out] IMFTransform **ppTransform
);

Parameter

[in] dwStreamIndex

Der Datenstrom, der für den MFT abfragt werden soll. Der Wert kann einer der folgenden Werte sein.

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

[in] dwTransformIndex

Der nullbasierte Index des abzurufenden MFT.

[out] pGuidCategory

Empfängt eine GUID, die die Kategorie des MFT angibt. Eine Liste der möglichen Werte finden Sie unter MFT_CATEGORY.

[out] ppTransform

Empfängt einen Zeiger auf die IMFTransform-Schnittstelle des MFT. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
MF_E_INVALIDINDEX
 Der dwTransformIndex-Parameter liegt außerhalb des Bereichs.
MF_E_INVALIDSTREAMNUMBER
 Der dwStreamIndex-Parameter ist ungültig.

Hinweise

Mit dieser Methode können Sie eine MFT konfigurieren, nachdem sie in die Verarbeitungskette eingefügt wurde. Verwenden Sie den in ppTransform zurückgegebenen Zeiger nicht, um Medientypen für den MFT festzulegen oder Daten zu verarbeiten. Insbesondere kann das Aufrufen einer der folgenden IMFTransform-Methoden zu unerwarteten Ergebnissen führen.

Wenn ein Decoder vorhanden ist, wird er an der Indexposition 0 angezeigt.

Um den Verlust von Daten zu vermeiden, sollten Sie den Quellleser entleeren, bevor Sie diese Methode aufrufen. Weitere Informationen finden Sie unter Entladen der Datenpipeline.

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