Función D3DXCheckTextureRequirements
Comprueba los parámetros de creación de texturas.
Sintaxis
HRESULT D3DXCheckTextureRequirements(
_In_ LPDIRECT3DDEVICE9 pDevice,
_Inout_ UINT *pWidth,
_Inout_ UINT *pHeight,
_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.
-
pWidth [in, out]
-
Tipo: UINT*
Puntero al ancho solicitado en píxeles o NULL. Devuelve el tamaño corregido.
-
pHeight [in, out]
-
Tipo: UINT*
Puntero al alto solicitado 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_INVALIDCALL, D3DERR_NOTAVAILABLE.
Comentarios
Si los parámetros de esta función no son válidos, esta función devuelve parámetros corregidos.
Esta función usa la heurística siguiente al comparar los requisitos solicitados con los formatos disponibles:
- No elija un formato que tenga menos canales.
- Evite los formatos FOURCC y de 24 bits a menos que se solicite explícitamente.
- Intente no agregar nuevos canales.
- Intente no cambiar el número de bits por canal.
- Intente evitar la conversión entre tipos de formatos. Por ejemplo, evite convertir un formato ARGB a un formato de profundidad.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también