D3DXCreateCubeTexture-Funktion

Erstellt eine leere Cubetextur und passt die aufrufenden Parameter nach Bedarf an.

Syntax

HRESULT D3DXCreateCubeTexture(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  UINT                   Size,
  _In_  UINT                   MipLevels,
  _In_  DWORD                  Usage,
  _In_  D3DFORMAT              Format,
  _In_  D3DPOOL                Pool,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

Größe [in]

Typ: UINT

Breite und Höhe der Cubetextur in Pixel. Wenn die Cubetextur beispielsweise ein Würfel mit 8 x 8 Pixeln ist, sollte der Wert für diesen Parameter 8 sein.

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, D3DUSAGE_RENDERTARGET oder D3DUSAGE_DYNAMIC. 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. Weitere Informationen zur Verwendung dynamischer Texturen finden Sie unter Verwenden dynamischer Texturen.

Formatieren [in]

Typ: D3DFORMAT

Mitglied des aufgezählten D3DFORMAT-Typs , der das angeforderte Pixelformat für die Cubetextur beschreibt. Die zurückgegebene Cubetextur hat möglicherweise ein anderes Format als das durch Format angegebene Format. Anwendungen sollten das Format der zurückgegebenen Cubetextur überprüfen.

Pool [in]

Typ: D3DPOOL

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

ppCubeTexture [out]

Typ: LPDIRECT3DCUBETEXTURE9*

Adresse eines Zeigers auf eine IDirect3DCubeTexture9-Schnittstelle , die das erstellte Cubetexturobjekt 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_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Bemerkungen

Cubetexturen unterscheiden sich von anderen Oberflächen darin, dass es sich um Sammlungen von Oberflächen handelt.

Intern verwendet D3DXCreateCubeTexture D3DXCheckCubeTextureRequirements , um die aufrufenden Parameter anzupassen. Daher sind Aufrufe von D3DXCreateCubeTexture häufig erfolgreich, wenn Aufrufe von CreateCubeTexture fehlschlagen würden.

Anforderungen

Siehe auch

Texturfunktionen in D3DX 9