共用方式為


IDirect3DDevice9::ColorFill 方法 (d3d9helper.h)

允許應用程式使用指定的色彩填滿D3DPOOL_DEFAULT表面的矩形區域。

語法

HRESULT ColorFill(
  [in] IDirect3DSurface9 *pSurface,
  [in] const RECT        *pRect,
  [in] D3DCOLOR          color
);

參數

[in] pSurface

類型: IDirect3DSurface9*

要填滿之表面的指標。

[in] pRect

類型:const RECT*

來源矩形的指標。 使用 Null 表示會填滿整個表面。

[in] color

類型: D3DCOLOR

用於填滿的色彩。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,則可以D3DERR_INVALIDCALL傳回值。

備註

這個方法只能套用至轉譯目標、轉譯目標紋理表面,或具有集區類型為 D3DPOOL_DEFAULT 的螢幕外純螢幕。

IDirect3DDevice9::ColorFill 將適用于所有格式。 不過,使用參考或軟體裝置時,唯一支援的格式是D3DFMT_X1R5G5B5、D3DFMT_A1R5G5B5、D3DFMT_R5G6B5、D3DFMT_X8R8G8B8、D3DFMT_A8R8G8B8、D3DFMT_YUY2、D3DFMT_G8R8_G8B8、D3DFMT_UYVY、D3DFMT_R8G8_B8G8、D3DFMT_R16F、D3DFMT_G16R16F、D3DFMT_A16B16G16R16F、D3DFMT_R32F、D3DFMT_G32R32F和D3DFMT_A32B32G32R32F。

使用 DirectX 7 或 DirectX 8.x 驅動程式時,唯一支援的 YUV 格式是D3DFMT_UYVY和D3DFMT_YUY2。

需求

   
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

D3DPOOL

IDirect3DDevice9