Share via


IMFSourceReader::GetNativeMediaType 方法 (mfreadwrite.h)

取得媒體來源原生支援的格式。

語法

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

參數

[in] dwStreamIndex

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

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

[in] dwMediaTypeIndex

指定要查詢的媒體類型。 此值可以是下列任一項。

意義
0–0xFFFFFFFE
媒體類型以零起始的索引
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
目前的原生媒體類型。

[out] ppMediaType

接收 IMFMediaType 介面的指標。 呼叫端必須釋放 介面。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 Description
S_OK
此方法已成功。
MF_E_INVALIDSTREAMNUMBER
dwStreamIndex 參數無效。
MF_E_NO_MORE_TYPES
dwMediaTypeIndex 參數超出範圍。

備註

這個方法會查詢基礎媒體來源的原生輸出格式。 可能,每個來源數據流可能會產生一個以上的輸出格式。 使用 dwMediaTypeIndex 參數來迴圈查看可用的格式。 一般而言,檔案來源每個數據流只提供一種格式,但擷取裝置可能會提供數種格式。

方法會傳回媒體類型的複本,因此可以放心地修改 ppMediaType 參數中收到的物件。

若要設定數據流的輸出類型,請呼叫 IMFSourceReader::SetCurrentMediaType 方法。

如果已安裝適用於 Windows Vista 的平臺更新補充,此介面可在 Windows Vista 上使用。

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfreadwrite.h

另請參閱

IMFSourceReader

來源讀取器