IMFSourceReaderEx::GetTransformForStream-Methode (mfreadwrite.h)

Artikel
02/28/2024

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

Freigeben über