D3DX11GetImageInfoFromFile 函式

注意

D3DX (D3DX 9、D3DX 10 和 D3DX 11) 公用程式程式庫已被取代為 Windows 8，且不支援 Windows 市集應用程式。

注意

建議您不要使用此函式，而是建議您使用 DirectXTex 程式庫 GetMetadataFromXXXFile (其中 XXX 是 WIC、DDS 或 TGA;WIC 不支援 DDS 和 TGA;D3DX 9 支援 TGA 作為遊戲) 的常見藝術來源格式。

擷取指定影像檔的相關資訊。

語法

HRESULT D3DX11GetImageInfoFromFile(
  _In_  LPCTSTR           pSrcFile,
  _In_  ID3DX11ThreadPump *pPump,
  _In_  D3DX11_IMAGE_INFO *pSrcInfo,
  _Out_ HRESULT           *pHResult
);

參數

pSrcFile [in]

類型： LPCTSTR

要擷取相關資訊的映射檔案名。 如果已定義 UNICODE 或_UNICODE，則此參數類型為 LPCWSTR，否則類型為 LPCSTR。

pPump [in]

類型： ID3DX11ThreadPump*

選擇性執行緒幫浦，可用來以非同步方式載入資訊。 可以是 Null。 請參閱 ID3DX11ThreadPump 介面。

pSrcInfo [in]

類型： D3DX11_IMAGE_INFO*

要填入原始程式檔中資料描述的 D3DX11_IMAGE_INFO 指標。

pHResult [out]

類型： HRESULT*

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

傳回值

類型： HRESULT

如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列專案：D3DERR_INVALIDCALL

備註

此函式同時支援 Unicode 和 ANSI 字串。

規格需求

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

另請參閱

D3DX 函式