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 圖元,這個方法就會失敗。

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcomp.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Trim