D3DXCreateCubeTextureFromFileInMemory 函式

從記憶體中的檔案建立 Cube 紋理。

語法

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

參數

pDevice [in]

類型： LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標，代表要與 Cube 紋理相關聯的裝置。

pSrcData [in]

類型： LPCVOID

要從中建立 Cubemap 的記憶體中檔案指標。 請參閱＜備註＞。

SrcDataSize [in]

類型： UINT

記憶體中檔案的大小，以位元組為單位。

ppCubeTexture [out]

類型： LPDIRECT3DCUBETEXTURE9*

IDirect3DCubeTexture9介面指標的位址，代表建立的 Cube 紋理物件。

傳回值

類型： HRESULT

如果函式成功，傳回值會D3D_OK。 如果函式失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、D3DXERR_INVALIDDATA E_OUTOFMEMORY。

備註

此函式支援下列檔案格式：.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm 和 .tga。 請參閱 D3DXIMAGE_FILEFORMAT。

函式相當於 D3DXCreateCubeTextureFromFileInMemoryEx (pDevice， pSrcData， SrcDataSize， D3DX_DEFAULT， D3DX_DEFAULT， 0， D3DFMT_UNKNOWN， D3DPOOL_MANAGED， D3DX_DEFAULT， D3DX_DEFAULT， 0， Null， Null， ppCubeTexture) 。

請注意，從 IDirect3DDevice9 物件呼叫時，以這個函式建立的資源將會放在D3DPOOL_MANAGED所表示的記憶體類別中。 從 IDirect3DDevice9Ex 物件呼叫這個方法時，資源將會放在D3DPOOL_DEFAULT所表示的記憶體類別中。

此方法的設計目的是用來載入儲存為RT_RCDATA的影像檔，這是應用程式定義的資源 (原始資料) 。 否則，此方法將會失敗。

篩選會自動套用至使用此方法建立的紋理。 篩選相當於D3DX_FILTER_TRIANGLE |D3DX_FILTER中的 D3DX_FILTER_DITHER。

D3DXCreateCubeTextureFromFileInMemory 使用 DirectDraw 介面 (DDS) 檔案格式。 DirectX 紋理編輯器 (Dxtex.exe) 可讓您從其他檔案格式產生 Cube 對應，並以 DDS 檔案格式儲存。 您可以從 DirectX SDK 取得Dxtex.exe並瞭解。 如需 DirectX SDK 的相關資訊，請參閱 DirectX SDK 在哪裡？。

規格需求

需求	值
標頭	D3dx9tex.h
程式庫	D3dx9.lib

另請參閱

D3DX 9 中的紋理函式