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

Consulte también

Funciones de textura en D3DX 9