IMFTransform：：SetOutputType 方法 (mftransform.h)

設定、測試或清除此媒體基礎上輸出數據流的媒體類型， (MFT) 。

語法

HRESULT SetOutputType(
  [in] DWORD        dwOutputStreamID,
  [in] IMFMediaType *pType,
  [in] DWORD        dwFlags
);

[in] dwOutputStreamID

輸出數據流識別碼。若要取得數據流標識碼的清單，請呼叫 IMFTransform：：GetStreamIDs。

[in] pType

IMFMediaType 介面的指標，或 NULL。

[in] dwFlags

_MFT_SET_TYPE_FLAGS 列舉中的零個或多個旗標。

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

傳回碼	描述
S_OK	此方法已成功。
MF_E_INVALIDMEDIATYPE	轉換無法使用建議的媒體類型。
MF_E_INVALIDSTREAMNUMBER	無效的數據流標識碼。
MF_E_INVALIDTYPE	建議的類型無效。此錯誤碼表示媒體類型本身未正確設定;例如，它可能包含相互衝突的旗標。
MF_E_TRANSFORM_CANNOT_CHANGE_MEDIATYPE_WHILE_PROCESSING	MFT 無法在處理數據時切換類型。請嘗試清空或排清 MFT。
MF_E_TRANSFORM_TYPE_NOT_SET	您必須先設定輸入類型，才能設定輸出類型。
MF_E_UNSUPPORTED_D3D_TYPE	MFT 找不到適當的 DirectX 影片加速 (DXVA) 組態。

這個方法可用來設定、測試而不設定，或清除媒體類型：

若要設定媒體類型，請將 dwFlags 設定為零，並將 pType 設定為指定媒體類型的非 NULL 指標。
若要在不設定媒體類型的情況下測試媒體類型，請將 dwFlags 設定為 MFT_SET_TYPE_TEST_ONLY ，並將 pType 設定為指定媒體類型的非 NULL 指標。如果可接受媒體類型，方法會傳回 S_OK。否則，它會傳回 MF_E_INVALIDMEDIATYPE。不論傳回值為何，目前的媒體類型都不會變更。
若要清除媒體類型，請將 pType 設定為 NULL。

在一個數據流上設定媒體類型可能會變更另一個數據流上可接受的類型。

在設定輸出類型之前，MFT 可能需要呼叫端設定一或多個輸入類型。如果是，方法會傳回 MF_E_TRANSFORM_TYPE_NOT_SET。

如果 MFT 支援 DirectX 影片加速 (DXVA) 但找不到適當的 DXVA 組態 (例如，如果圖形驅動程式沒有正確的功能) ，則方法應該會傳回 MF_E_UNSUPPORTED_D3D_TYPE。如需詳細資訊，請參閱在媒體基礎中支援 DXVA 2.0。

如果在包含 mftransform.h 之前定義 MFT_UNIQUE_METHOD_NAMES ，這個方法會重新命名 為 MFTSetOutputType。請參閱建立混合式 DMO/MFT 物件。

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	mftransform.h
程式庫	Mfuuid.lib