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 |
|
| Bibliothek |
|
Siehe auch