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 驱动程序时，仅支持D3DFMT_UYVY和D3DFMT_YUY2的 YUV 格式。

要求

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

另请参阅

D3DPOOL

IDirect3DDevice9