IVideoWindow::GetMinIdealImageSize

  • [アーティクル]

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

構文

  HRESULT GetMinIdealImageSize(
    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 構造体の dwCaps メンバに DDCAPS_BLTSTRETCH フラグが含まれている。「IDirectDrawVideo::GetCaps」を参照すること)。
  • ビデオ サーフェイスに最小オーバーレイ拡大がない。(DDCAPS 構造体の dwMinOverlayStretch メンバが 0。「IDirectDrawVideo::GetCaps」を参照すること)。

参照