D3DXCreateTexture-Funktion
Erstellt eine leere Textur und passt die aufrufenden Parameter nach Bedarf an.
Syntax
HRESULT D3DXCreateTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DTEXTURE9 *ppTexture
);
Parameter
-
pDevice [in]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das der Textur zugeordnet werden soll.
-
Breite [in]
-
Typ: UINT
Breite in Pixel. Wenn dieser Wert 0 ist, wird der Wert 1 verwendet. Siehe Hinweise.
-
Höhe [in]
-
Typ: UINT
Höhe in Pixel. Wenn dieser Wert 0 ist, wird der Wert 1 verwendet. Siehe Hinweise.
-
MipLevels [in]
-
Typ: UINT
Anzahl der angeforderten Mip-Ebenen. Wenn dieser Wert null oder D3DX_DEFAULT ist, wird eine vollständige Mipmap-Kette erstellt.
-
Verwendung [in]
-
Typ: DWORD
0, D3DUSAGE_RENDERTARGET oder D3DUSAGE_DYNAMIC. Wenn Sie dieses Flag auf D3DUSAGE_RENDERTARGET festlegen, wird angegeben, dass die Oberfläche durch Aufrufen der SetRenderTarget-Methode als Renderziel verwendet werden soll. Wenn entweder D3DUSAGE_RENDERTARGET oder D3DUSAGE_DYNAMIC angegeben ist, sollte die Anwendung überprüfen, ob das Gerät diesen Vorgang unterstützt, indem CheckDeviceFormat aufgerufen wird. Weitere Informationen zur Verwendung dynamischer Texturen finden Sie unter Verwenden dynamischer Texturen.
-
Format [in]
-
Typ: D3DFORMAT
Member des aufgezählten D3DFORMAT-Typs , der das angeforderte Pixelformat für die Textur beschreibt. Die zurückgegebene Textur hat möglicherweise ein anderes Format als das angegebene Format, wenn das Gerät das angeforderte Format nicht unterstützt. Anwendungen sollten das Format der zurückgegebenen Textur überprüfen, um festzustellen, ob sie mit dem angeforderten Format übereinstimmt.
-
Pool [in]
-
Typ: D3DPOOL
Member des aufgezählten D3DPOOL-Typs , der die Speicherklasse beschreibt, in der die Textur platziert werden soll.
-
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 wie folgt aussehen: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.
Bemerkungen
Intern verwendet D3DXCreateTexture D3DXCheckTextureRequirements , um die aufrufenden Parameter anzupassen. Daher sind Aufrufe von D3DXCreateTexture häufig erfolgreich, wenn Aufrufe von CreateTexture fehlschlagen würden.
Wenn Höhe und Breite auf D3DX_DEFAULT festgelegt sind, wird für beide Parameter der Wert 256 verwendet. Wenn Höhe oder Breite auf D3DX_DEFAULT und der andere Parameter auf einen numerischen Wert festgelegt ist, ist die Textur quadratisch, wobei die Höhe und Breite dem numerischen Wert entspricht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch