IMFSourceReader::GetNativeMediaType 方法 (mfreadwrite.h)
取得媒體來源原生支援的格式。
語法
HRESULT GetNativeMediaType(
[in] DWORD dwStreamIndex,
[in] DWORD dwMediaTypeIndex,
[out] IMFMediaType **ppMediaType
);
參數
[in] dwStreamIndex
指定要查詢的數據流。 此值可以是下列任一項。
值 | 意義 |
---|---|
|
數據流以零起始的索引。 |
|
第一個視訊串流。 |
|
第一個音訊數據流。 |
[in] dwMediaTypeIndex
指定要查詢的媒體類型。 此值可以是下列任一項。
值 | 意義 |
---|---|
|
媒體類型以零起始的索引 |
|
目前的原生媒體類型。 |
[out] ppMediaType
接收 IMFMediaType 介面的指標。 呼叫端必須釋放 介面。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | Description |
---|---|
|
此方法已成功。 |
|
dwStreamIndex 參數無效。 |
|
dwMediaTypeIndex 參數超出範圍。 |
備註
這個方法會查詢基礎媒體來源的原生輸出格式。 可能,每個來源數據流可能會產生一個以上的輸出格式。 使用 dwMediaTypeIndex 參數來迴圈查看可用的格式。 一般而言,檔案來源每個數據流只提供一種格式,但擷取裝置可能會提供數種格式。
方法會傳回媒體類型的複本,因此可以放心地修改 ppMediaType 參數中收到的物件。
若要設定數據流的輸出類型,請呼叫 IMFSourceReader::SetCurrentMediaType 方法。
如果已安裝適用於 Windows Vista 的平臺更新補充,此介面可在 Windows Vista 上使用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista 和平臺更新補充 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfreadwrite.h |