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 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

• Service Pack 2 (SP2) 以降の Windows XP。
• Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

• WINDOWS XP SP2 以降。
• Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

こちらもご覧ください

IMFMediaTypeHandler