D3DXCheckCubeTextureRequirements-Funktion

Artikel
06/13/2023

Überprüft die Parameter für die Cubetexturerstellung.

Syntax

HRESULT D3DXCheckCubeTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pSize,
  _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 Cubetextur zugeordnet werden soll.

pSize [ein, aus]

Typ: UINT*

Zeiger auf die angeforderte Breite und Höhe 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

0 oder D3DUSAGE_RENDERTARGET. Durch Festlegen dieses Flags auf D3DUSAGE_RENDERTARGET wird angegeben, dass die Oberfläche als Renderziel verwendet werden soll. Die Ressource kann dann an den pNewRenderTarget-Parameter der SetRenderTarget-Methode übergeben werden. Wenn D3DUSAGE_RENDERTARGET angegeben ist, sollte die Anwendung überprüfen, ob das Gerät diesen Vorgang unterstützt, indem CheckDeviceFormat aufgerufen wird.

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

Cubetexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Sammlungen von Oberflächen handelt. Um SetRenderTarget mit einer Cubetextur aufzurufen, müssen Sie mithilfe von GetCubeMapSurface ein einzelnes Gesicht auswählen und die resultierende Oberfläche an SetRenderTarget übergeben.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9

Share via