D3DDDIDEVINFO_VCACHE Struktur (d3dumddi.h)
Die D3DDDIDEVINFO_VCACHE Struktur beschreibt die Vertexcacheinformationen eines Geräts.
Syntax
typedef struct _D3DDDIDEVINFO_VCACHE {
[out] UINT Pattern;
[out] UINT OptMethod;
[out] UINT CacheSize;
[out] UINT MagicNumber;
} D3DDDIDEVINFO_VCACHE;
Angehörige
[out] Pattern
Das Bitmuster. Der Treiber muss das Bitmuster als vierstelligen CACH-Codewert (FOURCC) angeben. Der Treiber kann das folgende MAKEFOURCC-Makro verwenden, um den FOURCC-Wert als CACH anzugeben:
MAKEFOURCC('C', 'A', 'C', 'H');
[out] OptMethod
Die Methode der Gitteroptimierung. Der Treiber kann einen der folgenden Werte verwenden, um die verwendete Gitteroptimierung anzugeben.
| Wert | Bedeutung |
|---|---|
| D3DXMESHOPT_STRIPREORDER (0) | Optimierung der längsten Streifen |
| D3DXMESHOPT_VCACHE (1) | Vertexcachebasierte Optimierung |
[out] CacheSize
Die effektive Größe in Einträgen, für die der Treiber den Vertexcache optimiert. Die tatsächliche Cachegröße muss nicht die Größe sein, die in CacheSize angegeben wird, da die tatsächliche Cachegröße in den meisten Situationen größer ist. Der Treiber gibt eine optimierte Größe in CacheSize- nur an, wenn er auch D3DXMESHOPT_VCACHE im OptMethod Member angibt.
[out] MagicNumber
Die Zahl, die als Teil einer Test- und Fehlerprozedur verwendet werden soll, wenn ermittelt wird, wann die Stripsliste neu gestartet werden soll. Diese Zahl kann zwischen 1 und dem Wert sein, der im CacheSize Member angegeben ist. In der Regel sind die besten Werte in der Nähe CacheSize/2. Der Treiber gibt eine Zahl in MagicNumber nur an, wenn er auch D3DXMESHOPT_VCACHE im OptMethod Member angibt.
Bemerkungen
Direct3D-Laufzeitversion 9.0 und höher. Die Microsoft Direct3D-Laufzeit ruft die CreateQuery-Funktion des Treibers auf, um treiberseitige Ressourcen für die Vertex-Cache-Abfrage zu erstellen. In diesem CreateQuery-Aufruf gibt die Laufzeit den D3DDDIQUERYTYPE_VCACHE Abfragetyp im QueryType Member der D3DDDIARG_CREATEQUERY Struktur an. Der Treiber sollte eine D3DDDIDEVINFO_VCACHE Struktur zuordnen. Die Laufzeit ruft dann die IssueQuery-Funktion des Treibers auf, um die Vertexcacheabfrage zu verarbeiten. Der Treiber sollte eine GPU-Anweisung (Graphics Processing Unit) einfügen, um die Vertexcachedaten in eine Zuordnung zu schreiben. Um die Vertexcacheinformationen vom Treiber abzurufen, ruft die Laufzeit die GetQueryData--Funktion des Treibers auf. In diesem GetQueryData- Aufruf sollte der Treiber die Zuordnung sperren und die Vertexcachedaten im pData- Member der D3DDDIARG_GETQUERYDATA Struktur zurückgeben, auf die der pData--Parameter verweist.
Nur Direct3D-Laufzeitversion 8.1. Die Direct3D-Laufzeit ruft die GetInfo--Funktion des Treibers auf, um Vertexcacheinformationen vom Treiber abzurufen. In diesem GetInfo- Aufruf übergibt die Laufzeit das D3DDDIDEVINFOID_VCACHE Flag im DevInfoID Parameter. Der Treiber gibt Vertexcacheinformationen in einer D3DDDIDEVINFO_VCACHE Struktur an und gibt sie an der pDevInfoStruct Parameter zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |