D3DXCreateVolumeTexture-Funktion
Erstellt eine leere Volumetextur und passt die aufrufenden Parameter nach Bedarf an.
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 0 (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 0 (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 0 (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 0 (null) oder D3DX _ DEFAULT ist, wird eine vollständige Mipmapkette erstellt.
-
Verwendung [ In]
-
Typ: DWORD
0 oder D3DUSAGE _ DYNAMIC. Weitere Informationen zur Verwendung dynamischer Texturen finden Sie unter Verwenden von dynamischen Texturen.
-
Formatieren [ In]
-
Typ: D3DFORMAT
Member des aufzählten D3DFORMAT-Typs, der das angeforderte Pixelformat für die Volumetextur beschreibt. Die zurückgegebene Volumetextur hat möglicherweise ein anderes Format als das von Format angegebene Format. Anwendungen sollten das Format der zurückgegebenen Volumetextur überprüfen.
-
Pool [ In]
-
Typ: D3DPOOL
Member des aufzä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, ist 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 .
Hinweise
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 |
|