次の方法で共有

IAMVideoCompression::GetInfo メソッド (strmif.h)

  • [アーティクル]

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

メソッドは GetInfo 、機能や既定値など、フィルターの圧縮プロパティに関する情報を取得します。

構文

HRESULT GetInfo(
  [out]     LPWSTR pszVersion,
  [in, out] int    *pcbVersion,
  [out]     LPWSTR pszDescription,
  [in, out] int    *pcbDescription,
  [out]     long   *pDefaultKeyFrameRate,
  [out]     long   *pDefaultPFramesPerKey,
  [out]     double *pDefaultQuality,
  [out]     long   *pCapabilities
);

パラメーター

[out] pszVersion

"バージョン 2.1.0" などのバージョン文字列を受け取るバッファーへのポインター。

[in, out] pcbVersion

バージョン文字列のサイズをバイト単位で受け取ります。

[out] pszDescription

"My Video Compressor" などの説明文字列を受け取るバッファーへのポインター。

[in, out] pcbDescription

説明文字列のサイズをバイト単位で受け取ります。

[out] pDefaultKeyFrameRate

既定のキー フレーム レートを受け取ります。

[out] pDefaultPFramesPerKey

キー フレームあたりの予測 (P) フレームの既定のレートを受け取ります。

[out] pDefaultQuality

既定の品質を受け取ります。

[out] pCapabilities

0 個以上の CompressionCaps フラグのビットごとの組み合わせとして、圧縮機能を受け取ります。

戻り値

HRESULT 値を返します。

注釈

一覧表示されているパラメーターは NULL にすることができます。この 場合、メソッドはそのパラメーターを無視します。

アプリケーションは、バージョンと説明の文字列のバッファーを割り当てる必要があります。 バッファーの必要なサイズを確認するには、pszVersion パラメーターと pszDescription パラメーターに対して NULL を指定してこのメソッドを呼び出します。 次のコードに示すように、 pcbVersion と pcbDescription で返される値を使用してバッファーを割り当て、メソッドを再度呼び出します。

C++ 
// Get the size of the version and description strings, in bytes.
int cbVersion, cbDesc; 
hr = pCompress->GetInfo(NULL, &cbVersion, NULL, &cbDesc, 
    NULL, NULL, NULL, NULL);
if (SUCCEEDED(hr))
{
    // Allocate the buffers.
    WCHAR *pszVersion = new WCHAR[cbVersion / sizeof(WCHAR)];  
    WCHAR *pszDesc = new WCHAR[cbDesc / sizeof(WCHAR)];

    // Now query for the strings.
    hr = pCompress->GetInfo(pszVersion, &cbVersion, pszDesc, &cbDesc, 
        NULL, NULL, NULL, NULL);
    }
    delete [] pszVersion;
    delete [] pszDesc;
}
文字列はワイド文字列であり、返されるサイズは文字数ではなくバイト単位であることに注意してください。 また、一方または両方の文字列は長さが 0 である可能性があります。

pCapabilities パラメーターは、サポートされている圧縮プロパティと、どの IAMVideoCompression メソッドがサポートされているかを示すフラグのセットを受け取ります。 たとえば、 CompressionCaps_CanKeyFrame フラグが返された場合、フィルターは IAMVideoCompression::get_KeyFrameRate メソッドと IAMVideoCompression::p ut_KeyFrameRate メソッドをサポートします。

残りのパラメーターは、圧縮プロパティの既定値を受け取ります。 サポートされていないプロパティの場合 ( pCapabilities で返されるフラグによって決まります)、対応する既定値は正しくないか意味がない可能性があるため、無視する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

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

IAMVideoCompression インターフェイス