IAMStreamConfig::GetFormat メソッド (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

メソッドは GetFormat 、現在または優先される出力形式を取得します。

構文

HRESULT GetFormat(
  [out] AM_MEDIA_TYPE **ppmt
);

パラメーター

[out] ppmt

AM_MEDIA_TYPE構造体へのポインターのアドレス。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

注釈

ピンが接続されている場合、このメソッドは、ピンが現在使用している形式を返します。 それ以外の場合、メソッドは次のピン接続用にピンの優先形式を返します。 IAMStreamConfig::SetFormat メソッドを既に呼び出して形式を設定している場合は、GetFormat同じ形式が返されます。 そうでない場合は、 IPin::EnumMediaTypes メソッドによって決定された、ピンの優先形式の一覧の最初の形式が返されます。

メソッドは、 AM_MEDIA_TYPE 構造体のメモリを割り当て、構造体を入力して pmt パラメーターで返します。 呼び出し元は、フォーマット ブロックを含むメモリを解放する必要があります。 基本クラス ライブラリで DeleteMediaType ヘルパー関数を使用できます。

一部の圧縮フィルターでは、フィルターの入力ピンが接続されていない場合、メソッドは失敗します。

例

IAMStreamConfig *pConfig = NULL;
// Query the output pin for IAMStreamConfig (not shown).
AM_MEDIA_TYPE *pmt = NULL;
hr = pConfig->GetFormat(&pmt);
if (SUCCEEDED(hr))
{
    /* Examine the media type for any information you need. */
    DeleteMediaType(pmt);
}
pConfig->Release();

要件

こちらもご覧ください

エラーコードと成功コード

IAMStreamConfig インターフェイス