Freigeben über


IMFSourceReaderEx::GetTransformForStream-Methode (mfreadwrite.h)

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

Syntax

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

Die Parameter

[in] dwStreamIndex

Der Datenstrom, der für die MFT-Abfrage verwendet werden soll. Der Wert kann eine der folgenden Sein:

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

[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 Description
S_OK
Erfolg.
MF_E_INVALIDINDEX
Der dwTransformIndex-Parameter liegt außerhalb des Bereichs.
MF_E_INVALIDSTREAMNUMBER
Der dwStreamIndex-Parameter ist ungültig.

Bemerkungen

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 die 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 Null angezeigt.

Um zu vermeiden, dass Daten verloren gehen, sollten Sie den Quellleser entwässern, bevor Sie diese Methode aufrufen. Weitere Informationen finden Sie unter Entwässern der Datenpipeline.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header mfreadwrite.h

Siehe auch

IMFSourceReaderEx-