次の方法で共有


IMFMediaTypeHandler::IsMediaTypeSupported メソッド (mfidl.h)

オブジェクトが指定したメディアの種類をサポートしているかどうかを照会します。

構文

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

パラメーター

[in] pMediaType

チェックするメディアの種類の IMFMediaType インターフェイスへのポインター。

[out] ppMediaType

最も近い一致するメディアの種類の IMFMediaType インターフェイスへのポインターを受け取るか、値 NULL を受け取ります。 NULL 以外の場合、呼び出し元はインターフェイスを解放する必要があります。 このパラメーターは、NULL でもかまいません。 「解説」を参照してください。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
メソッドが成功しました。
MF_E_INVALIDMEDIATYPE
オブジェクトは、このメディアの種類をサポートしていません。

注釈

オブジェクトが pMediaType で指定されたメディアの種類をサポートしている場合、メソッドは S_OKを返します。 メディア ソースの場合は、ソースがそのメディアの種類に準拠するデータを生成できることを意味します。 メディア シンクの場合、シンクは、そのメディアの種類に準拠するデータを受信できることを意味します。 オブジェクトがメディアの種類をサポートしていない場合、 メソッドは失敗します。

ppMediaType パラメーターは省略可能です。 メソッドが失敗した場合、オブジェクトは ppMediaType を使用して、オブジェクトがサポートするメディアの種類を返し、 pMediaType で指定されたものと密接に一致します。 メソッドは、 ppMediaType でメディアの種類を返す保証はありません。 型が返されない場合、このパラメーターは NULL ポインターを受け取ります。 メソッドが成功した場合、このパラメーターは NULL ポインターを受け取ります。 呼び出し元が ppMediaTypeNULL に設定した場合、このパラメーターは無視されます。

このインターフェイスは、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 Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。
  • WINDOWS XP SP2 以降。
  • Windows XP Media Center Edition 2005 と KB900325 (Windows XP Media Center Edition 2005) とKB925766 (2006 年 10 月 Windows XP Media Center Edition の更新プログラムのロールアップ) がインストールされています。

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfidl.h
Library Mfuuid.lib

こちらもご覧ください

IMFMediaTypeHandler