D3DXLoadVolumeFromMemory

Loads a volume from memory.

HRESULT D3DXLoadVolumeFromMemory(
  LPDIRECT3DVOLUME8 pDestVolume,
  CONST PALETTEENTRY* pDestPalette,
  CONST D3DBOX* pDestBox,
  LPCVOID pSrcMemory,
  D3DFORMAT SrcFormat,
  UINT SrcRowPitch,
  UINT SrcSlicePitch,
  CONST PALETTEENTRY* pSrcPalette,
  CONST D3DBOX* pSrcBox,
  DWORD Filter,
  D3DCOLOR ColorKey
);

Parameters

pDestVolume

[in] Pointer to an IDirect3DVolume8 interface. Specifies the destination volume, which receives the image.

pDestPalette

[in] Pointer to a PALETTEENTRY structure, the destination palette of 256 colors or NULL.

pDestBox

[in] Pointer to a D3DBOX structure. Specifies the destination box. Set this parameter to NULL to specify the entire volume.

pSrcMemory

[in] Pointer to the top-left corner of the source volume in memory.

SrcFormat

[in] Member of the D3DFORMAT enumerated type, the pixel format of the source volume.

SrcRowPitch

[in] Pitch of source image, in bytes. For DXT formats (compressed texture formats), this number should represent the size of one row of cells, in bytes.

SrcSlicePitch

[in] Pitch of source image, in bytes. For DXT formats (compressed texture formats), this number should represent the size of one slice of cells, in bytes.

pSrcPalette

[in] Pointer to a PALETTEENTRY structure, the source palette of 256 colors or NULL. See Remarks.

pSrcBox

[in] Pointer to a D3DBOX structure. Specifies the source box. Set this parameter to NULL to specify the entire volume.

Filter

[in] A combination of one or more D3DX_FILTER flags controlling how the image is filtered. Specifying D3DX_DEFAULT for this parameter is the equivalent of specifying D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey

[in] D3DCOLOR value to replace with transparent black, or 0 to disable the colorkey. This is always a 32-bit ARGB color, independent of the source image format. Alpha is significant and should usually be set to FF for opaque colorkeys. Thus, for opaque black, the value would be equal to 0xFF000000.

Return Values

If the function succeeds, the return value is D3D_OK.

If the function fails, the return value can be one of the following values.

Remarks

Writing to a non-level-zero volume of the volume texture will not cause the dirty rectangle to be updated. If D3DXLoadVolumeFromMemory is called and the texture was not already dirty (this is unlikely under normal usage scenarios), the application needs to explicitly call IDirect3DVolumeTexture8::AddDirtyBox on the volume texture.

Requirements

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

See Also

D3DXLoadVolumeFromFile, D3DXLoadVolumeFromResource, D3DXLoadVolumeFromVolume