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

Artículo
02/26/2024

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íxeles del nivel anterior (independientemente). Cada dimensión se sujeta a 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íxeles del nivel anterior (independientemente). Cada dimensión se sujeta a 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íxeles del nivel anterior (independientemente). Cada dimensión se sujeta a 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 de la textura. Si es cero, Direct3D generará todos los subniveles 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 usar, use D3DUSAGE_DYNAMIC o D3DUSAGE_SOFTWAREPROCESSING. Para obtener más información, consulte D3DUSAGE.

[in] Format

Tipo: D3DFORMAT

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

[in] Pool

Tipo: D3DPOOL

Miembro del D3DPOOL tipo enumerado, 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 ejecuta 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.