D3DXCreateCubeTextureFromFileInMemory-Funktion
Erstellt eine Cubetextur aus einer Datei im Arbeitsspeicher.
Syntax
HRESULT D3DXCreateCubeTextureFromFileInMemory(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parameter
-
pDevice [ In]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle, die das Gerät darstellt, das der Cubetextur zugeordnet werden soll.
-
pSrcData [ In]
-
Typ: LPCVOID
Zeiger auf die Datei im Arbeitsspeicher, aus der die Cubemap erstellt werden soll. Siehe Hinweise.
-
SrcDataSize [ In]
-
Typ: UINT
Größe der Datei im Arbeitsspeicher in Bytes.
-
ppCubeTexture [ out]
-
Typ: LPDIRECT3DCUBETEXTURE9*
Adresse eines Zeigers auf eine IDirect3DCubeTexture9-Schnittstelle, die das erstellte Cubetexturobjekt darstellt.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Sein: D3DERR _ INVALIDCALL, D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, 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 D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, D3DFMT _ UNKNOWN, D3DPOOL _ MANAGED, D3DX _ DEFAULT, D3DX _ DEFAULT, 0, NULL, NULL, ppCubeTexture).
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 bezeichnet _ wird.
Diese Methode ist für das Laden von Bilddateien konzipiert, die als RT RCDATA gespeichert sind. Dabei handelt es sich um eine anwendungsdefinierte _ Ressource (Rohdaten). Andernfalls kann diese Methode nicht verwendet werden.
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.
D3DXCreateCubeTextureFromFileInMemory verwendet das DirectDraw-Oberflächendateiformat (DDS). Mit dem DirectX-Textur-Editor (Dxtex.exe) können Sie eine Cubemap aus anderen Dateiformaten generieren und im DDS-Dateiformat speichern. Sie können sich Dxtex.exe DirectX SDK darüber informieren. Informationen zum DirectX SDK finden Sie unter Wo ist das DirectX SDK?.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|