D3DXCreateVolumeTextureFromFileInMemory-Funktion

Erstellt eine Volumetextur aus einer Datei im Arbeitsspeicher.

Syntax

HRESULT D3DXCreateVolumeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  LPCVOID                  pSrcFile,
  _In_  UINT                     SrcData,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 ppVolumeTexture
);

Parameter

pDevice [ In]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle, die das Gerät darstellt, das der Volumetextur zugeordnet werden soll.

pSrcFile [ In]

Typ: LPCVOID

Zeiger auf die Datei im Arbeitsspeicher, aus der die Volumetextur erstellt werden soll.

SrcData [ In]

Typ: UINT

Größe der Datei im Arbeitsspeicher in Bytes.

ppVolumeTexture [ out]

Typ: LPDIRECT3DVOLUMETEXTURE9

Adresse eines Zeigers auf eine IDirect3DVolumeTexture9-Schnittstelle, die das erstellte Texturobjekt darstellt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA, E _ OUTOFMEMORY.

Hinweise

Diese Funktion unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE _ FILEFORMAT.

Die Funktion entspricht D3DXCreateVolumeTextureFromFileInMemoryEx(pDevice, pSrcFile, SrcData, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, D3DFMT _ UNKNOWN, D3DPOOL _ MANAGED, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, NULL, NULL, ppVolumeTexture).

Beachten Sie, dass eine Ressource, die mit dieser Funktion erstellt wird, wenn sie von einem IDirect3DDevice9-Objekt aufgerufen wird, in der Speicherklasse platziert wird, die von D3DPOOL MANAGED bezeichnet _ wird. Wenn diese Methode von einem IDirect3DDevice9Ex-Objekt aufgerufen wird, wird die Ressource in der Speicherklasse platziert, die durch D3DPOOL DEFAULT gekennzeichnet _ ist.

Die Filterung wird automatisch auf eine Textur angewendet, die mit dieser Methode erstellt wurde. Die Filterung entspricht D3DX _ FILTER _ TRIANGLE | D3DX _ FILTER _ DITHER in D3DX _ FILTER.

Anforderungen

Anforderung Wert
Header
D3dx9tex.h
Bibliothek
D3dx9.lib

Siehe auch

D3DXCreateVolumeTextureFromFile

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

D3DXCreateVolumeTextureFromResourceEx

Texturfunktionen in D3DX 9