D3DX11CreateShaderResourceViewFromFile 函数

注意

D3DX (D3DX 9、D3DX 10 和 D3DX 11) 实用工具库已弃用Windows 8,不支持 Windows 应用商店应用。

注意

建议不要使用此函数,而是使用以下函数:

  • DirectXTK 库 (运行时) 、 CreateXXXTextureFromFile (其中 XXX 为 DDS 或 WIC)
  • DirectXTex 库 (工具) 、 LoadFromXXXFile (其中 XXX 为 WIC、DDS 或 TGA;WIC 不支持 DDS 和 TGA;D3DX 9 支持 TGA 作为游戏的常见艺术源格式,) 然后 CreateShaderResourceView

从文件创建着色器资源视图。

语法

HRESULT D3DX11CreateShaderResourceViewFromFile(
  _In_  ID3D11Device             *pDevice,
  _In_  LPCTSTR                  pSrcFile,
  _In_  D3DX11_IMAGE_LOAD_INFO   *pLoadInfo,
  _In_  ID3DX11ThreadPump        *pPump,
  _Out_ ID3D11ShaderResourceView **ppShaderResourceView,
  _Out_ HRESULT                  *pHResult
);

parameters

pDevice [in]

类型: ID3D11Device*

指向设备的指针 (将使用该资源的 ID3D11Device) 。

pSrcFile [in]

类型: LPCTSTR

包含着色器资源视图的文件的名称。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,数据类型将解析为 LPCSTR。

pLoadInfo [in]

类型: D3DX11_IMAGE_LOAD_INFO*

可选。 标识纹理的特征, (创建数据处理者时看到 D3DX11_IMAGE_LOAD_INFO) ;将此设置为 NULL ,以在加载纹理时读取纹理的特征。

pPump [in]

类型: ID3DX11ThreadPump*

指向线程泵接口的指针 (请参阅 ID3DX11ThreadPump 接口) 。 如果指定 NULL ,则此函数将同步运行,并且在完成之前不会返回。

ppShaderResourceView [out]

类型: ID3D11ShaderResourceView**

指向着色器资源视图的指针的地址 (请参阅 ID3D11ShaderResourceView) 。

pHResult [out]

类型: HRESULT*

指向返回值的指针。 可以为 NULL。 如果 pPump 不为 NULL,则 pHResult 必须是有效的内存位置,直到异步执行完成。

返回值

类型: HRESULT

返回值是 Direct3D 11 返回代码中列出的值之一。

备注

有关支持的图像格式的列表,请参阅 D3DX11_IMAGE_FILE_FORMAT

要求

要求
标头
D3DX11tex.h

D3DX11.lib

请参阅

D3DX 函数