Método IDirect3DDevice9::CreateVolumeTexture (d3d9helper.h)

Artículo
08/23/2023

Crea un recurso de textura de volumen.

Sintaxis

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

Parámetros

[in] Width

Tipo: UINT

Ancho del nivel superior de la textura del volumen, en píxeles. Este valor debe ser una potencia de dos si se establece el miembro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 . Las dimensiones de píxeles de los niveles posteriores serán el valor truncado de la mitad de la dimensión de píxel del nivel anterior (independientemente). Cada dimensión se fija en un tamaño de 1 píxel. Por lo tanto, si la división por dos da como resultado 0 (cero), se tomará 1 en su lugar. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

[in] Height

Tipo: UINT

Alto del nivel superior de la textura del volumen, en píxeles. Este valor debe ser una potencia de dos si se establece el miembro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 . Las dimensiones de píxeles de los niveles posteriores serán el valor truncado de la mitad de la dimensión de píxel del nivel anterior (independientemente). Cada dimensión se fija en un tamaño de 1 píxel. Por lo tanto, si la división en 2 da como resultado 0 (cero), se tomará 1 en su lugar. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

[in] Depth

Tipo: UINT

Profundidad del nivel superior de la textura del volumen, en píxeles. Este valor debe ser una potencia de dos si se establece el miembro D3DPTEXTURECAPS_VOLUMEMAP_POW2 de D3DCAPS9 . Las dimensiones de píxeles de los niveles posteriores serán el valor truncado de la mitad de la dimensión de píxel del nivel anterior (independientemente). Cada dimensión se fija en un tamaño de 1 píxel. Por lo tanto, si la división en 2 da como resultado 0 (cero), se tomará 1 en su lugar. La dimensión máxima que admite un controlador (para ancho, alto y profundidad) se puede encontrar en MaxVolumeExtent en D3DCAPS9.

[in] Levels

Tipo: UINT

Número de niveles en la textura. Si es cero, Direct3D generará todos los subveles de textura hasta 1x1 píxeles para hardware que admita texturas de volumen mipmapped. Llame a IDirect3DBaseTexture9::GetLevelCount para ver el número de niveles generados.

[in] Usage

Tipo: DWORD

El uso puede ser 0, lo que indica que no hay ningún valor de uso. Si se desea el uso, use D3DUSAGE_DYNAMIC o D3DUSAGE_SOFTWAREPROCESSING. Para obtener más información, consulte D3DUSAGE.

[in] Format

Tipo: D3DFORMAT

Miembro del tipo enumerado D3DFORMAT , que describe el formato de todos los niveles de la textura del volumen.

[in] Pool

Tipo: D3DPOOL

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

[out, retval] ppVolumeTexture

Tipo: IDirect3DVolumeTexture9**

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

[in] pSharedHandle

Tipo: HANDLE*

Reservado. Establezca este parámetro en NULL. Este parámetro se puede usar en Direct3D 9 para Windows Vista para compartir recursos.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.