D3DXLoadSurfaceFromMemory 関数
D3DXLoadSurfaceFromMemory 関数
メモリからサーフェイスをロードする。
構文
HRESULT D3DXLoadSurfaceFromMemory(
LPDIRECT3DSURFACE9 pDestSurface,
CONST PALETTEENTRY *pDestPalette,
CONST RECT *pDestRect,
LPCVOID pSrcMemory,
D3DFORMAT SrcFormat,
UINT SrcPitch,
CONST PALETTEENTRY *pSrcPalette,
CONST RECT *pSrcRect,
DWORD Filter,
D3DCOLOR ColorKey
);
パラメータ
- pDestSurface
[in] IDirect3DSurface9 インターフェイスへのポインタ。転送先のサーフェイスを指定する。このサーフェイスがイメージを受け取る。 - pDestPalette
[in] 256 色の転送先パレットである PALETTEENTRY 構造体へのポインタ、または NULL。 - pDestRect
[in] RECT 構造体へのポインタ。転送先矩形を指定する。このパラメータに NULL を設定して、サーフェイス全体を指定する。 - pSrcMemory
[in] メモリ内にあるソース イメージの左上隅へのポインタ。 - SrcFormat
[in] D3DFORMAT 列挙型のメンバ。ソース イメージのピクセル フォーマットである。 - SrcPitch
[in] ソース イメージのピッチ (バイト単位)。DXT フォーマットの場合、この数値はセルで構成される 1 つの行の幅 (バイト単位) を表す。 - pSrcPalette
[in] 256 色の転送元パレットである PALETTEENTRY 構造体へのポインタ、または NULL。 - pSrcRect
[in] RECT 構造体へのポインタ。メモリ内のソース イメージのディメンジョンを指定する。NULL を指定することはできない。 - Filter
[in] イメージをフィルタリングする方法を制御する 1 つあるいは複数の D3DX_FILTER の組み合わせ。このパラメータに D3DX_DEFAULT を指定することは、D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER を指定することと等しい。 - ColorKey
[in] 透明となる D3DCOLOR の値。カラー キーを無効にする場合は 0 を指定する。ソース イメージのフォーマットとは関係なく、これは常に 32 ビットの ARGB カラーである。アルファが有意であり、通常はカラー キーを不透明にする場合は FF を指定する。したがって、不透明な黒の場合、値は 0xFF000000 となる。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
| D3DERR_INVALIDCALL | メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。 |
| D3DXERR_INVALIDDATA | データが無効である。 |
注意
この関数は、圧縮テクスチャ フォーマット間の変換を処理する。
レベル ゼロ以外のサーフェイスに書き込んでも、ダーティー矩形は更新されない。D3DXLoadSurfaceFromMemory を呼び出したときに、サーフェイスがまだダーティーでない (そのようなことは、通常の使用方法ではあり得ない) 場合、アプリケーションはサーフェイスに対して IDirect3DTexture9::AddDirtyRect を明示的に呼び出す必要がある。
関数の情報
| ヘッダー | d3dx9tex.h |
| インポート ライブラリ | d3dx9.lib |
| 最低限のオペレーティング システム | Windows 98 |
参照