D3DXCreateTextureFromFileInMemory 函式
從記憶體中的檔案建立紋理。
語法
HRESULT D3DXCreateTextureFromFileInMemory(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
參數
-
pDevice [in]
-
IDirect3DDevice9介面的指標,代表要與紋理相關聯的裝置。
-
pSrcData [in]
-
類型: LPCVOID
記憶體中要從中建立紋理之檔案的指標。
-
SrcDataSize [in]
-
類型: UINT
在記憶體中檔案的大小,以位元組為單位。
-
ppTexture [out]
-
類型: LPDIRECT3DTEXTURE9*
代表所建立紋理物件的 IDirect3DTexture9 介面指標位址。
傳回值
類型: HRESULT
如果函式成功,傳回值會D3D_OK。 如果函式失敗,傳回值可以是下列其中一項:D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA E_OUTOFMEMORY。
備註
函式相當於 D3DXCreateTextureFromFileInMemoryEx (pDevice、pSrcData、SrcDataSize、D3DX_DEFAULT、D3DX_DEFAULT、D3DX_DEFAULT、0、D3DFMT_UNKNOWN、D3DPOOL_MANAGED、D3DX_DEFAULT、D3DX_DEFAULT、0、 Null、 Null、ppTexture) 。
此函式支援下列檔案格式:.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。
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|
另請參閱