Función D3DXCreateTexture

Crea una textura vacía, ajustando los parámetros de llamada según sea necesario.

Sintaxis

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parámetros

pDevice [in]

Tipo: LPDIRECT3DDEVICE9

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

Ancho [in]

Tipo: UINT

Ancho en píxeles. Si este valor es 0, se usa un valor de 1. Vea la sección Comentarios.

Alto [in]

Tipo: UINT

Alto en píxeles. Si este valor es 0, se usa un valor de 1. Vea la sección Comentarios.

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, D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC. Establecer esta marca en D3DUSAGE_RENDERTARGET indica que la superficie se va a usar como destino de representación mediante una llamada al método SetRenderTarget . Si se especifica D3DUSAGE_RENDERTARGET o D3DUSAGE_DYNAMIC , la aplicación debe comprobar que el dispositivo admite esta operación llamando a CheckDeviceFormat. 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. La textura devuelta puede ser de un formato diferente del especificado, si el dispositivo no admite el formato solicitado. Las aplicaciones deben comprobar el formato de la textura devuelta para ver si coincide con el formato solicitado.

Grupo [in]

Tipo: D3DPOOL

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

ppTexture [out]

Tipo: LPDIRECT3DTEXTURE9*

Dirección de un puntero a una interfaz IDirect3DTexture9 , que representa el objeto de textura creado.

Valor devuelto

Tipo: HRESULT

Si la función se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Comentarios

Internamente, D3DXCreateTexture usa D3DXCheckTextureRequirements para ajustar los parámetros de llamada. Por lo tanto, las llamadas a D3DXCreateTexture a menudo se realizarán correctamente en las llamadas a CreateTexture .

Si height y Width se establecen en D3DX_DEFAULT, se usa un valor de 256 para ambos parámetros. Si Height o Width se establece en D3DX_DEFAULT Y el otro parámetro se establece en un valor numérico, la textura será cuadrada con el alto y el ancho iguales al valor numérico.

Requisitos

Requisito	Value
Encabezado	D3dx9tex.h
Biblioteca	D3dx9.lib

Consulte también

Funciones de textura en D3DX 9