D3DXCheckTextureRequirements-Funktion

Überprüft Texturerstellungsparameter.

Syntax

HRESULT D3DXCheckTextureRequirements(
  _In_    LPDIRECT3DDEVICE9 pDevice,
  _Inout_ UINT              *pWidth,
  _Inout_ UINT              *pHeight,
  _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 Textur zugeordnet werden soll.

pWidth [in, out]

Typ: UINT*

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

pHeight [in, out]

Typ: UINT*

Zeiger auf die angeforderte 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. Das Festlegen dieses Flags auf D3DUSAGE_RENDERTARGET gibt an, 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 einen Member des aufgezählten D3DFORMAT-Typs . Gibt das gewünschte Pixelformat oder NULL an. Gibt das korrigierte Format zurück.

Pool [in]

Typ: D3DPOOL

Member 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_INVALIDCALL, D3DERR_NOTAVAILABLE.

Bemerkungen

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

Diese Funktion verwendet die folgende Heuristik, wenn die angeforderten Anforderungen mit verfügbaren Formaten verglichen werden:

• Wählen Sie kein Format mit weniger Kanälen aus.
• Vermeiden Sie FOURCC - und 24-Bit-Formate, sofern nicht explizit angefordert.
• Versuchen Sie, keine neuen Kanäle hinzuzufügen.
• Versuchen Sie, die Anzahl der Bits pro Kanal nicht zu ändern.
• Versuchen Sie, die Konvertierung zwischen Formattypen zu vermeiden. Vermeiden Sie bei instance die Konvertierung eines ARGB-Formats in ein Tiefenformat.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9