Función D3DXCreateVolumeTexture

Crea una textura de volumen vacía, ajustando los parámetros de llamada según sea necesario.

Sintaxis

HRESULT D3DXCreateVolumeTexture(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  UINT                     Width,
  _In_  UINT                     Height,
  _In_  UINT                     Depth,
  _In_  UINT                     MipLevels,
  _In_  DWORD                    Usage,
  _In_  D3DFORMAT                Format,
  _In_  D3DPOOL                  Pool,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

Puntero a una interfaz IDirect3DDevice9 , que representa el dispositivo que se va a asociar a la textura del volumen.

Ancho [in]

Tipo: UINT

Ancho en píxeles. Este valor debe ser distinto de cero. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

Alto [in]

Tipo: UINT

Alto en píxeles. Este valor debe ser distinto de cero. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

Profundidad [in]

Tipo: UINT

Profundidad en píxeles. Este valor debe ser distinto de cero. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

MipLevels [in]

Tipo: UINT

Número de niveles mip solicitados. Si este valor es cero o D3DX_DEFAULT, se crea una cadena de mapas MIP completa.

Uso [in]

Tipo: DWORD

0 o D3DUSAGE_DYNAMIC. Para obtener más información sobre el uso de texturas dinámicas, consulte Uso de texturas dinámicas.

Formato [in]

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato de píxel solicitado para la textura del volumen. La textura de volumen devuelta podría tener un formato diferente del especificado por Format. Las aplicaciones deben comprobar el formato de la textura de volumen devuelta.

Piscina [in]

Tipo: D3DPOOL

Miembro del tipo enumerado D3DPOOL , que describe la clase de memoria en la que se debe colocar la textura del volumen.

ppVolumeTexture [out]

Tipo: LPDIRECT3DVOLUMETEXTURE9*

Dirección de un puntero a una interfaz IDirect3DVolumeTexture9 , que representa el objeto de textura de volumen creado.

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, el valor devuelto se D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, E_OUTOFMEMORY .

Observaciones

Internamente, D3DXCreateVolumeTexture usa D3DXCheckVolumeTextureRequirements para ajustar los parámetros de llamada. Por lo tanto, las llamadas a D3DXCreateVolumeTexture a menudo se realizarán correctamente en las llamadas a CreateVolumeTexture .

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9