IMFSourceReader::GetNativeMediaType メソッド (mfreadwrite.h)

  • [アーティクル]

メディア ソースでネイティブにサポートされている形式を取得します。

構文

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

パラメーター

[in] dwStreamIndex

クエリを実行するストリームを指定します。 値には、次のいずれかを指定できます。

値 意味
0 ~ 0xFFFFFFFB
 ストリームの 0 から始まるインデックス。
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 最初のビデオ ストリーム。
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 最初のオーディオ ストリーム。

[in] dwMediaTypeIndex

クエリを実行するメディアの種類を指定します。 値には、次のいずれかを指定できます。

値 意味
0 – 0xFFFFFFFE
 メディアの種類の 0 から始まるインデックス
MF_SOURCE_READER_CURRENT_TYPE_INDEX
0xFFFFFFFF
 現在のネイティブ メディアの種類。

[out] ppMediaType

IMFMediaType インターフェイスへのポインターを受け取ります。 呼び出し元はインターフェイスを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドが成功しました。
MF_E_INVALIDSTREAMNUMBER
 dwStreamIndex パラメーターが無効です。
MF_E_NO_MORE_TYPES
 dwMediaTypeIndex パラメーターが範囲外です。

注釈

このメソッドは、基になるメディア ソースのネイティブ出力形式を照会します。 場合によっては、各ソース ストリームで複数の出力形式を生成できます。 dwMediaTypeIndex パラメーターを使用して、使用可能な形式をループ処理します。 一般に、ファイル ソースはストリームごとに 1 つの形式のみを提供しますが、キャプチャ デバイスではいくつかの形式が提供される場合があります。

メソッドはメディアの種類のコピーを返します。そのため、 ppMediaType パラメーターで受け取ったオブジェクトを変更しても問題ありません。

ストリームの出力の種類を設定するには、 IMFSourceReader::SetCurrentMediaType メソッドを呼び出します。

このインターフェイスは、Windows Vista のプラットフォーム更新プログラムの補足がインストールされている場合に、Windows Vista で使用できます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 用 Windows 7、Windows Vista およびプラットフォーム更新プログラムの補足 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー mfreadwrite.h

こちらもご覧ください

IMFSourceReader

ソース リーダー