D3DXCheckVolumeTextureRequirements-Funktion

Überprüft Volume-Texture-Creation-Parameter.

Syntax

HRESULT D3DXCheckVolumeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _Inout_ UINT              *pDepth,
  _Inout_ UINT              *pNumMipLevels,
  _In_    DWORD             Usage,
  _Inout_ D3DFORMAT         *pFormat,
  _In_    D3DPOOL           Pool
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

Zeiger auf eine IDirect3DDevice9-Schnittstelle , die das Gerät darstellt, das der Volumetextur zugeordnet werden soll.

pWidth [ein, aus]

Typ: UINT*

Zeiger auf die angeforderte Breite in Pixel oder NULL. Gibt die korrigierte Größe zurück.

pHeight [ein, aus]

Typ: UINT*

Zeiger auf die angeforderte Höhe in Pixel oder NULL. Gibt die korrigierte Größe zurück.

pDepth [ein, aus]

Typ: UINT*

Zeiger auf die angeforderte Tiefe in Pixel oder NULL. Gibt die korrigierte Größe zurück.

pNumMipLevels [in, out]

Typ: UINT*

Zeiger auf die Anzahl der angeforderten Mipmap-Ebenen oder NULL. Gibt die korrigierte Anzahl von MIPMAP-Ebenen zurück.

Verwendung [in]

Typ: DWORD

Derzeit nicht verwendet, legen Sie auf 0 fest.

pFormat [in, out]

Typ: D3DFORMAT*

Zeiger auf ein Element des aufgezählten D3DFORMAT-Typs . Gibt das gewünschte Pixelformat ( NULL) an. Gibt das korrigierte Format zurück.

Pool [in]

Typ: D3DPOOL

Mitglied des aufgezählten D3DPOOL-Typs , der die Speicherklasse beschreibt, in der die Volumetextur platziert werden soll.

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_INVALIDCALL.

Bemerkungen

Wenn Parameter für diese Funktion ungültig sind, gibt diese Funktion korrigierte Parameter zurück.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9