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
D3dx9tex.h
Bibliothek
D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9