Función D3DX11CreateTextureFromFile

Nota

La biblioteca de utilidades D3DX (D3DX 9, D3DX 10 y D3DX 11) está en desuso para Windows 8 y no es compatible con las aplicaciones de la Tienda Windows.

Nota

En lugar de usar esta función, se recomienda usar estas opciones:

  • Biblioteca directXTK (runtime), CreateXXXTextureFromFile (donde XXX es DDS o WIC)
  • Biblioteca directXTex (herramientas), LoadFromXXXFile (donde XXX es WIC, DDS o TGA; WIC no admite DDS y TGA; TGA compatible con D3DX 9 como un formato de origen de arte común para juegos) a continuación, CreateTexture

Cree un recurso de textura a partir de un archivo.

Sintaxis

HRESULT D3DX11CreateTextureFromFile(
  _In_  ID3D11Device           *pDevice,
  _In_  LPCTSTR                pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO *pLoadInfo,
  _In_  ID3DX11ThreadPump      *pPump,
  _Out_ ID3D11Resource         **ppTexture,
  _Out_ HRESULT                *pHResult
);

Parámetros

pDevice [in]

Tipo: ID3D11Device*

Puntero al dispositivo (consulte ID3D11Device) que usará el recurso.

pSrcFile [in]

Tipo: LPCTSTR

Nombre del archivo que contiene el recurso. Si la configuración del compilador requiere Unicode, el tipo de datos LPCTSTR se resuelve en LPCWSTR. De lo contrario, el tipo de datos se resuelve en LPCSTR.

pLoadInfo [in]

Tipo: D3DX11_IMAGE_LOAD_INFO*

Opcional. Identifica las características de una textura (consulte D3DX11_IMAGE_LOAD_INFO) cuando se crea el procesador de datos; establézcalo en NULL para leer las características de una textura cuando se carga la textura.

pPump [in]

Tipo: ID3DX11ThreadPump*

Puntero a una interfaz de bomba de subproceso (consulte ID3DX11ThreadPump Interface). Si se especifica NULL , esta función se comportará de forma sincrónica y no devolverá hasta que finalice.

ppTexture [out]

Tipo: ID3D11Resource**

Dirección de un puntero al recurso de textura (consulte ID3D11Resource).

pHResult [out]

Tipo: HRESULT*

Puntero al valor devuelto. Puede ser NULL. Si pPump no es NULL, pHResult debe ser una ubicación de memoria válida hasta que se complete la ejecución asincrónica.

Valor devuelto

Tipo: HRESULT

El valor devuelto es uno de los valores enumerados en Códigos de retorno de Direct3D 11.

Requisitos

Requisito Value
Encabezado
D3DX11.h
Biblioteca
D3DX11.lib

Consulte también

Funciones D3DX