IDirect3DDevice9::ColorFill 方法 (d3d9.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 驱动程序时,仅支持D3DFMT_UYVY和D3DFMT_YUY2的 YUV 格式。

要求

   
目标平台 Windows
标头 d3d9.h (包括 D3D9.h)
Library D3D9.lib

请参阅

D3DPOOL

IDirect3DDevice9