D3DXCreateTextureFromResource 函式
從資源建立紋理。
語法
HRESULT D3DXCreateTextureFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
參數
-
pDevice [in]
-
IDirect3DDevice9介面的指標，代表要與紋理相關聯的裝置。
-
hSrcModule [in]
-
類型： HMODULE
處理資源所在的模組，或針對與作業系統用來建立目前進程之映射相關聯的模組 Null 。
-
pSrcResource [in]
-
類型： LPCTSTR
指定資源名稱之字串的指標。 如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR。 否則，字串資料類型會解析為 LPCSTR。 請參閱＜備註＞。
-
ppTexture [out]
-
類型： LPDIRECT3DTEXTURE9*
代表所建立紋理物件的 IDirect3DTexture9 介面指標位址。
傳回值
類型： HRESULT
如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
備註
編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 D3DXCreateTextureFromResourceW。 否則，函式呼叫會解析為 D3DXCreateTextureFromResourceA，因為正在使用 ANSI 字串。
函式相當於 D3DXCreateTextureFromResourceEx (pDevice、hSrcModule、pSrcResource、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 Null、 Null、ppTexture) 。
正在載入的資源的類型必須是 RT_BITMAP 或 RT_RCDATA。 資源類型RT_RCDATA用來載入點陣圖以外的格式 (，例如 .tga、.jpg和 .dds) 。
此函式支援下列檔案格式：.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 請參閱 D3DXIMAGE_FILEFORMAT。
請注意，從 IDirect3DDevice9 物件呼叫時，以這個函式建立的資源將會放在D3DPOOL_MANAGED所表示的記憶體類別中。 從 IDirect3DDevice9Ex 物件呼叫這個方法時，資源將會放在D3DPOOL_DEFAULT所表示的記憶體類別中。
篩選會自動套用至使用此方法建立的紋理。 篩選相當於D3DX_FILTER_TRIANGLE |D3DX_FILTER中的 D3DX_FILTER_DITHER。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱