IDCompositionVirtualSurface::Resize メソッド (dcomp.h)

この仮想サーフェスオブジェクトの論理サイズを変更します。

構文

HRESULT Resize(
  [in] UINT width,
  [in] UINT height
);

[in] width

型: UINT

仮想サーフェスの新しい幅 (ピクセル単位)。最大幅は 16,777,216 ピクセルです。

[in] height

型: UINT

仮想サーフェスの新しい高さ (ピクセル単位)。最大高さは 16,777,216 ピクセルです。

種類: HRESULT

関数が成功した場合は、S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。エラーコードの一覧については、「 DirectComposition エラーコード」を参照してください。

仮想サーフェスのサイズが変更されると、その内容はサーフェスの新しい境界まで保持されます。サーフェスを小さくした場合、以前に割り当てられたピクセルのうち、新しい幅または高さの範囲外にあるピクセルはすべて破棄されます。

このビットマップに対して IDCompositionSurface::BeginDraw が呼び出された場合、 IDCompositionSurface::EndDraw への対応する呼び出しがない場合、このメソッドは失敗します。

幅または高さが 16,777,216 ピクセルを超えると、このメソッドは失敗します。