IMFMediaTypeHandler：：IsMediaTypeSupported 方法 (mfidl.h)

查詢物件是否支援指定的媒體類型。

語法

HRESULT IsMediaTypeSupported(
  [in]  IMFMediaType *pMediaType,
  [out] IMFMediaType **ppMediaType
);

參數

[in] pMediaType

要檢查之媒體類型 之IMFMediaType 介面的指標。

[out] ppMediaType

接收最接近相符媒體類型的 IMFMediaType 介面指標，或接收 NULL值。 如果為非 NULL，則呼叫端必須釋放 介面。 此參數可以是 Null。 請參閱＜備註＞。

傳回值

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

備註

如果物件支援 pMediaType 中提供的媒體類型，方法會 傳回S_OK。 針對媒體來源，這表示來源可以產生符合該媒體類型的數據。 針對媒體接收，這表示接收可以接收符合該媒體類型的數據。 如果物件不支援媒體類型，方法就會失敗。

ppMediaType 參數是選擇性的。 如果方法失敗，物件可能會使用 ppMediaType 傳回物件所支援的媒體類型，且與 pMediaType 中提供的媒體類型非常相符。 此方法不保證會在 ppMediaType 中傳回媒體類型。 如果未傳回任何類型，此參數會收到 NULL 指標。 如果方法成功，此參數會收到 NULL 指標。 如果呼叫端將 ppMediaType 設定為 NULL，則會忽略此參數。

如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此介面可在下列平臺上使用：

• Windows XP with Service Pack 2 (SP2) 和更新版本。
• 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月更新匯總) 的 Windows XP Media Center Edition 2005。

• Windows XP 與 SP2 和更新版本。
• 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center Edition 2005) 和 KB925766 (2006 年 10 月更新匯總) 的 Windows XP Media Center Edition 2005。

規格需求

另請參閱

IMFMediaTypeHandler