D3DXCreateVolumeTexture-Funktion
Erstellt eine leere Volumetextur, wobei die aufrufenden Parameter nach Bedarf angepasst werden.
Syntax
HRESULT D3DXCreateVolumeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Width,
_In_ UINT Height,
_In_ UINT Depth,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Parameter
-
pDevice [in]
-
Typ: LPDIRECT3DDEVICE9
Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das der Volumetextur zugeordnet werden soll.
-
Breite [in]
-
Typ: UINT
Breite in Pixel. Dieser Wert muss ungleich null sein. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.
-
Höhe [in]
-
Typ: UINT
Höhe in Pixel. Dieser Wert muss ungleich null sein. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.
-
Tiefe [in]
-
Typ: UINT
Tiefe in Pixel. Dieser Wert muss ungleich null sein. Die maximale Dimension, die ein Treiber unterstützt (für Breite, Höhe und Tiefe), finden Sie in MaxVolumeExtent in D3DCAPS9.
-
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 oder D3DUSAGE_DYNAMIC. 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 Volumetextur beschreibt. Die zurückgegebene Volumetextur hat möglicherweise ein anderes Format als das durch Format angegebene. Anwendungen sollten das Format der zurückgegebenen Volumetextur überprüfen.
-
Pool [in]
-
Typ: D3DPOOL
Member des aufgezählten D3DPOOL-Typs , der die Speicherklasse beschreibt, in der die Volumetextur platziert werden soll.
-
ppVolumeTexture [out]
-
Typ: LPDIRECT3DVOLUMETEXTURE9*
Adresse eines Zeigers auf eine IDirect3DVolumeTexture9-Schnittstelle , die das erstellte Volumetexturobjekt 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, E_OUTOFMEMORY .
Bemerkungen
Intern verwendet D3DXCreateVolumeTexture D3DXCheckVolumeTextureRequirements , um die aufrufenden Parameter anzupassen. Daher sind Aufrufe von D3DXCreateVolumeTexture häufig erfolgreich, wenn Aufrufe von CreateVolumeTexture fehlschlagen würden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Weitere Informationen