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

  • [アーティクル]

オブジェクトのメディアの種類を設定します。

構文

HRESULT SetCurrentMediaType(
  [in] IMFMediaType *pMediaType
);

パラメーター

[in] pMediaType

新しいメディアの種類の IMFMediaType インターフェイスへのポインター。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_INVALIDREQUEST
 無効な要求です。

解説

メディア ソースの場合、メディアの種類を設定すると、ソースはそのメディアの種類に準拠するデータを生成することを意味します。 メディア シンクの場合、メディアの種類を設定すると、シンクはそのメディアの種類に準拠するデータを受信できることを意味します。

このメソッドの実装では、pMediaType がオブジェクトの現在のメディアの種類と異なるかどうかをチェックする必要があります。 型が同じ場合、メソッドは S_OKを返しますが、リソースを不必要に解放して再作成しないようにする必要があります。 型が同一でない場合、メソッドは新しい型を検証する必要があります。

このインターフェイスは、Windows Media Format 11 SDK 再頒布可能コンポーネントがインストールされている場合、次のプラットフォームで使用できます。

  • Windows XP 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 の更新プログラムのロールアップ) がインストールされています。

要件

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

関連項目

IMFMediaTypeHandler