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

Weitere Informationen

Texturfunktionen in D3DX 9