Microsoft DirectX 8.1 (C++)

D3DXFillVolumeTexture

Uses a user-provided function to fill each texel of each mip level of a given texture.

HRESULT D3DXFillVolumeTexture(
  LPDIRECT3DVOLUMETEXTURE8 pVolumeTexture,
  LPD3DXFILL3D             pFunction,
  LPVOID                   pData
);

Parameters

pVolumeTexture

[out, retval] Pointer to an IDirect3DVolumeTexture8 interface, representing the filled texture.

pFunction

[in] Pointer to an LPD3DXFILL3D user-provided evaluator function, which will be used to compute the value of each texel.

pData

[in] Pointer to an arbitrary block of user-defined data. This pointer will be passed to the function provided in pFunction.

Return Values

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be the following value.

D3DERR_INVALIDCALL

Remarks

If the volume is nondynamic (because of a usage parameter set to 0 at the creation) and located in video memory (the memory pool set to D3DPOOL_DEFAULT), D3DXFillVolumeTexture will fail because Direct3DX cannot lock nondynamic volumes located in video memory.

Requirements

  Header: Declared in D3dx8tex.h.
  Import Library: Use D3dx8.lib.