Función D3DXCheckCubeTextureRequirements

Comprueba los parámetros de creación de texturas de cubo.

Sintaxis

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

pSize [in, out]

Tipo: UINT*

Puntero al ancho y alto solicitados en píxeles, o NULL. Devuelve el tamaño corregido.

pNumMipLevels [in, out]

Tipo: UINT*

Puntero al número de niveles de mapa MIP solicitados o NULL. Devuelve el número corregido de niveles de mapa mip.

Uso [in]

Tipo: DWORD

0 o D3DUSAGE_RENDERTARGET. Establecer esta marca en D3DUSAGE_RENDERTARGET indica que la superficie se va a usar como destino de representación. A continuación, el recurso se puede pasar al parámetro pNewRenderTarget del método SetRenderTarget . Si se especifica D3DUSAGE_RENDERTARGET, la aplicación debe comprobar que el dispositivo admite esta operación mediante una llamada a CheckDeviceFormat.

pFormat [in, out]

Tipo: D3DFORMAT*

Puntero a un miembro del tipo enumerado D3DFORMAT . Especifica el formato de píxel deseado o NULL. Devuelve el formato corregido.

Piscina [in]

Tipo: D3DPOOL

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

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_INVALIDCALL.

Comentarios

Si los parámetros de esta función no son válidos, esta función devuelve parámetros corregidos.

Las texturas de cubo difieren de otras superficies en que son colecciones de superficies. Para llamar a SetRenderTarget con una textura de cubo, debe seleccionar una cara individual mediante GetCubeMapSurface y pasar la superficie resultante a SetRenderTarget.

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9