D3DXCreateTexture-Funktion

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

Syntax

HRESULT D3DXCreateTexture(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  UINT               Width,
  _In_  UINT               Height,
  _In_  UINT               MipLevels,
  _In_  DWORD              Usage,
  _In_  D3DFORMAT          Format,
  _In_  D3DPOOL            Pool,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Parameter

pDevice [in]

Typ: LPDIRECT3DDEVICE9

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

Breite [in]

Typ: UINT

Breite in Pixel. Wenn dieser Wert 0 ist, wird der Wert 1 verwendet. Siehe Hinweise.

Höhe [in]

Typ: UINT

Höhe in Pixel. Wenn dieser Wert 0 ist, wird der Wert 1 verwendet. Siehe Hinweise.

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. Wenn Sie dieses Flag auf D3DUSAGE_RENDERTARGET festlegen, wird angegeben, dass die Oberfläche durch Aufrufen der SetRenderTarget-Methode als Renderziel verwendet werden soll. Wenn entweder D3DUSAGE_RENDERTARGET oder D3DUSAGE_DYNAMIC 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.

Format [in]

Typ: D3DFORMAT

Member des aufgezählten D3DFORMAT-Typs , der das angeforderte Pixelformat für die Textur beschreibt. Die zurückgegebene Textur hat möglicherweise ein anderes Format als das angegebene Format, wenn das Gerät das angeforderte Format nicht unterstützt. Anwendungen sollten das Format der zurückgegebenen Textur überprüfen, um festzustellen, ob sie mit dem angeforderten Format übereinstimmt.

Pool [in]

Typ: D3DPOOL

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

ppTexture [out]

Typ: LPDIRECT3DTEXTURE9*

Adresse eines Zeigers auf eine IDirect3DTexture9-Schnittstelle , die das erstellte Texturobjekt 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 wie folgt aussehen: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Bemerkungen

Intern verwendet D3DXCreateTexture D3DXCheckTextureRequirements , um die aufrufenden Parameter anzupassen. Daher sind Aufrufe von D3DXCreateTexture häufig erfolgreich, wenn Aufrufe von CreateTexture fehlschlagen würden.

Wenn Höhe und Breite auf D3DX_DEFAULT festgelegt sind, wird für beide Parameter der Wert 256 verwendet. Wenn Höhe oder Breite auf D3DX_DEFAULT und der andere Parameter auf einen numerischen Wert festgelegt ist, ist die Textur quadratisch, wobei die Höhe und Breite dem numerischen Wert entspricht.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9