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