IMFCaptureSource::GetAvailableDeviceMediaType メソッド (mfcaptureengine.h)

  • [アーティクル]

キャプチャ ストリームのいずれかでサポートされている形式を取得します。

構文

HRESULT GetAvailableDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] DWORD        dwMediaTypeIndex,
  [in] IMFMediaType **ppMediaType
);

パラメーター

[in] dwSourceStreamIndex

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

値 意味
0 ~ 0xFFFFFFFB
 ストリームの 0 から始まるインデックス。 ストリームの数を取得するには、 IMFCaptureSource::GetDeviceStreamCount を呼び出します。
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 最初のイメージ ストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 最初のビデオ ストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 最初のオーディオ ストリーム。

[in] dwMediaTypeIndex

取得するメディアの種類の 0 から始まるインデックス。

[in] ppMediaType

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

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。
MF_E_INVALIDSTREAMNUMBER
 dwSourceStreamIndex パラメーターが無効です。
MF_E_NO_MORE_TYPES
 dwMediaTypeIndex パラメーターが範囲外です。

注釈

ストリームで使用可能なすべての形式を列挙するには、メソッドが MF_E_NO_MORE_TYPESを返すまで 、dwMediaTypeIndex のインクリメント中にループでこのメソッド を呼び出します。

一部のカメラでは、さまざまなフレーム レートがサポートされている場合があります。 最小フレーム レートと最大フレーム レートは、メディア タイプの MF_MT_FRAME_RATE_RANGE_MIN および MF_MT_FRAME_RATE_RANGE_MAX 属性に格納されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mfcaptureengine.h

こちらもご覧ください

IMFCaptureSource