IMFSourceReaderEx：：GetTransformForStream 方法 (mfreadwrite.h)

取得指定數據流的媒體基礎轉換指標 (MFT) 。

語法

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

參數

[in] dwStreamIndex

要查詢 MFT 的數據流。 此值可以是下列任一項。

值	意義
0–0xFFFFFFFB	數據流以零起始的索引。
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	第一個視訊串流。
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	第一個音訊數據流。

[in] dwTransformIndex

要擷取之 MFT 之以零起始的索引。

[out] pGuidCategory

接收指定 MFT 類別的 GUID。 如需可能值的清單，請參閱 MFT_CATEGORY。

[out] ppTransform

接收 MFT 之 IMFTransform 介面的指標。 呼叫端必須釋放 介面。

傳回值

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	成功。
MF_E_INVALIDINDEX	dwTransformIndex 參數超出範圍。
MF_E_INVALIDSTREAMNUMBER	dwStreamIndex 參數無效。

備註

您可以在將 MFT 插入處理鏈結之後，使用此方法來設定 MFT。 請勿使用 ppTransform 中傳回的指標來設定 MFT 上的媒體類型或處理數據。 特別是，呼叫下列任何 IMFTransform 方法可能會產生非預期的結果。

• AddInputStreams
• DeleteInputStream
• ProcessEvent
• ProcessInput
• ProcessMessage
• ProcessOutput
• SetInputType
• SetOutputType

如果譯碼器存在，它會出現在索引位置零。

若要避免遺失任何數據，您應該先清空來源讀取器，再呼叫此方法。 如需詳細資訊，請參閱 清空數據管線。

規格需求

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	mfreadwrite.h

另請參閱

IMFSourceReaderEx