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
Handle für das Modul, in dem sich die Ressource befindet, oder NULL für das Modul, das dem Image zugeordnet ist, mit dem das Betriebssystem den aktuellen Prozess erstellt hat.
-
pSrcResource [ In]
-
Typ: LPCTSTR
Zeiger auf eine Zeichenfolge, die den Ressourcennamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR auflösen. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR auflösen. 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, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einen der folgenden Werte haben: 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 D3DXCreateTextureFromResourceW auflösen. Andernfalls wird der Funktionsaufruf in D3DXCreateTextureFromResourceA auflösen, 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 zu ladende Ressource muss vom Typ RT _ BITMAP oder RT _ RCDATA sein. Der 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 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.
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 |
|
| Bibliothek |
|