D3DX11CreateTextureFromFile function
- DirectXTK library (runtime), CreateXXXTextureFromFile (where XXX is DDS or WIC)
- DirectXTex library (tools), LoadFromXXXFile (where XXX is WIC, DDS, or TGA; WIC doesn't support DDS and TGA; D3DX 9 supported TGA as a common art source format for games) then CreateTexture
Create a texture resource from a file.
Syntax
HRESULT D3DX11CreateTextureFromFile( _In_ ID3D11Device *pDevice, _In_ LPCTSTR pSrcFile, _In_ D3DX11_IMAGE_LOAD_INFO *pLoadInfo, _In_ ID3DX11ThreadPump *pPump, _Out_ ID3D11Resource **ppTexture, _Out_ HRESULT *pHResult );
Parameters
- pDevice [in]
-
Type: ID3D11Device*
A pointer to the device (see ID3D11Device) that will use the resource.
- pSrcFile [in]
-
Type: LPCTSTR
The name of the file containing the resource. If the compiler settings require Unicode, the data type LPCTSTR resolves to LPCWSTR. Otherwise, the data type resolves to LPCSTR.
- pLoadInfo [in]
-
Type: D3DX11_IMAGE_LOAD_INFO*
Optional. Identifies the characteristics of a texture (see D3DX11_IMAGE_LOAD_INFO) when the data processor is created; set this to NULL to read the characteristics of a texture when the texture is loaded.
- pPump [in]
-
Type: ID3DX11ThreadPump*
A pointer to a thread pump interface (see ID3DX11ThreadPump Interface). If NULL is specified, this function will behave synchronously and will not return until it is finished.
- ppTexture [out]
-
Type: ID3D11Resource**
The address of a pointer to the texture resource (see ID3D11Resource).
- pHResult [out]
-
Type: HRESULT*
A pointer to the return value. May be NULL. If pPump is not NULL, then pHResult must be a valid memory location until the asynchronous execution completes.
Return value
Type: HRESULT
The return value is one of the values listed in Direct3D 11 Return Codes.
Requirements
|
Header |
|
|---|---|
|
Library |
|
See also