D3DXCreateTextureFromResource-Funktion

Erstellt eine Textur aus einer Ressource.

Syntax

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

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

hSrcModule [in]

Typ: HMODULE

Behandeln Sie das Modul, in dem sich die Ressource befindet, oder NULL für ein Modul, das dem Image zugeordnet ist, das das Betriebssystem zum Erstellen des aktuellen Prozesses verwendet hat.

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.

ppTexture [out]

Typ: LPDIRECT3DTEXTURE9*

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

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Bemerkungen

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

Die Funktion entspricht D3DXCreateTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

Die geladene Ressource muss vom Typ RT_BITMAP oder RT_RCDATA sein. Ressourcentyp RT_RCDATA wird verwendet, um andere Formate als Bitmaps (z. B. TGA, .jpg und DDS) zu laden.

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 wurde, 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 von D3DPOOL_DEFAULT bezeichnet wird.

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

D3DXCreateTextureFromResourceEx

Texturfunktionen in D3DX 9