D3DDDIDEVINFO_VCACHE-Struktur (d3dumddi.h)

Artikel
02/26/2024

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;

Member

[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)	Auf Vertexcache basierende 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 der größe entsprechen, die in CacheSize angegeben ist, da die tatsächliche Cachegröße in den meisten Fällen größer ist. Der Treiber gibt eine optimierte Größe in CacheSize nur an, wenn er auch D3DXMESHOPT_VCACHE im OptMethod-Element angibt.

[out] MagicNumber

Die Zahl, die als Teil einer Test-und-Fehler-Prozedur 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-Element angegeben ist. In der Regel liegen die besten Werte in der Nähe von CacheSize/2. Der Treiber gibt eine Zahl in MagicNumber nur an, wenn er auch D3DXMESHOPT_VCACHE im OptMethod-Element angibt.

Hinweise

Direct3D-Laufzeitversion 9.0 und höher. Die Microsoft Direct3D-Runtime ruft die CreateQuery-Funktion des Treibers auf, um treiberseitige Ressourcen für die Vertex-Cache-Abfrage zu erstellen. In diesem CreateQuery-Aufruf gibt die Runtime den D3DDDIQUERYTYPE_VCACHE Abfragetyp im QueryType-Member der D3DDDIARG_CREATEQUERY-Struktur an. Der Treiber sollte eine D3DDDIDEVINFO_VCACHE Struktur zuordnen. Die Runtime ruft dann die IssueQuery-Funktion des Treibers auf, um die Vertex-Cache-Abfrage 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 Runtime die GetQueryData-Funktion des Treibers auf. In diesem GetQueryData-Aufruf sollte der Treiber die Zuordnung sperren und die Vertexcachedaten am pData-Member der D3DDDIARG_GETQUERYDATA Struktur zurückgeben, auf die der pData-Parameter verweist.

Nur Direct3D-Runtimeversion 8.1. Die Direct3D-Runtime ruft die GetInfo-Funktion des Treibers auf, um Vertexcacheinformationen vom Treiber abzurufen. In diesem GetInfo-Aufruf übergibt die Runtime das flag D3DDDIDEVINFOID_VCACHE im DevInfoID-Parameter . Der Treiber gibt Vertexcacheinformationen in einer D3DDDIDEVINFO_VCACHE-Struktur an und gibt sie am pDevInfoStruct-Parameter zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	d3dumddi.h (include D3dumddi.h)