D3DXCreateVolumeTextureFromResource-Funktion

Erstellt eine Volumetextur aus einer Ressource.

Syntax

HRESULT D3DXCreateVolumeTextureFromResource(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  HMODULE                  hSrcModule,
  _In_  LPCTSTR                  pSrcResource,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Parameter

pDevice [ In]

Typ: LPDIRECT3DDEVICE9

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

hSrcModule [ In]

Typ: HMODULE

Handle für das Modul, in dem sich die Ressource befindet, oder NULL für das Modul, das dem Image zugeordnet ist, das vom Betriebssystem zum Erstellen des aktuellen Prozesses verwendet wurde.

pSrcResource [ In]

Typ: LPCTSTR

Zeiger auf eine Zeichenfolge, die den Ressourcennamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

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

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXCreateVolumeTextureFromResourceW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXCreateVolumeTextureFromResourceA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Die Funktion entspricht D3DXCreateVolumeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, D3DFMT _ UNKNOWN, D3DPOOL _ MANAGED, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, NULL, NULL, ppVolumeTexture).

Die geladene Ressource muss eine anwendungsdefinierte Ressource (RT _ RCDATA) sein.

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

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

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResourceEx

Texturfunktionen in D3DX 9