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 |
|
| Biblioteca |
|
Consulte también