IVideoWindow::GetMaxIdealImageSize

  • [アーティクル]

GetMaxIdealImageSize メソッドは、ビデオ イメージの理想的な最大画像サイズを取得する。

構文

  HRESULT GetMaxIdealImageSize(
    long *pWidth,
    long *pHeight
);

パラメータ

pWidth

[out] 理想的な最大の幅を受け取る変数へのポインタ (ピクセル単位)。

pHeight

[out] 理想的な最大の高さを受け取る変数へのポインタ (ピクセル単位)。

戻り値

次のいずれかの値を返す。

値 説明
E_POINTER NULL ポインタ。
S_FALSE 最大画像サイズを取得できない。
S_OK 成功。
VFW_E_WRONG_STATE フィルタが停止している。

注意

ビデオ ハードウェアには特定の拡大縮小要件がある場合があるので、理想的な最大サイズは元のビデオ サイズとは異なる場合がある。

このメソッドは次のようにさまざまな状況で S_FALSE を返す。

  • フィルタが IOverlay トランスポートを使っている。
  • UseWhenFullScreen モードがオンになっている (「IDirectDrawVideo::UseWhenFullScreen」を参照すること)。
  • ビデオ サーフェイスに最大オーバーレイ拡大がない。(DDCAPS 構造体の dwMaxOverlayStretch メンバが 0。「IDirectDrawVideo::GetCaps」を参照すること)。

参照