D3DXCreateTextureFromResource 関数

  • [アーティクル]

リソースからテクスチャを作成します。

構文

HRESULT D3DXCreateTextureFromResource(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  HMODULE            hSrcModule,
  _In_  LPCTSTR            pSrcResource,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

テクスチャに関連付けるデバイスを表す 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 に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXCreateTextureFromResourceA に解決されます。

この関数は、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します。

要件

要件 値
ヘッダー
D3dx9tex.h
ライブラリ
D3dx9.lib

関連項目

D3DXCreateTextureFromResourceEx

D3DX 9 のテクスチャ関数