共用方式為


D3DX11CreateTextureFromFile 函式

注意

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 作為遊戲的常見藝術來源格式,) 則 CreateTexture

從檔案建立紋理資源。

語法

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

參數

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 ,則此函式會以同步方式運作,且在完成之前不會傳回。

ppTexture [out]

類型: ID3D11Resource**

紋理資源的指標位址 (請參閱 ID3D11Resource) 。

pHResult [out]

類型: HRESULT*

傳回值的指標。 可能是 Null。 如果 pPump 不是 Null,則 pHResult 必須是有效的記憶體位置,直到非同步執行完成為止。

傳回值

類型: HRESULT

傳回值是 Direct3D 11 傳回碼中列出的其中一個值。

規格需求

需求
標頭
D3DX11.h
程式庫
D3DX11.lib

另請參閱

D3DX 函式