structure D3DDDIDEVINFO_VCACHE (d3dumddi.h)

La structure D3DDDIDEVINFO_VCACHE décrit les informations de cache de vertex d’un appareil.

Syntaxe

typedef struct _D3DDDIDEVINFO_VCACHE {
  [out] UINT Pattern;
  [out] UINT OptMethod;
  [out] UINT CacheSize;
  [out] UINT MagicNumber;
} D3DDDIDEVINFO_VCACHE;

Membres

[out] Pattern

Modèle de bits. Le pilote doit spécifier le modèle de bits sous la forme d’une valeur DE code à quatre caractères (FOURCC) CACH. Le pilote peut utiliser la macro MAKEFOURCC suivante pour spécifier la valeur FOURCC comme CACH :

MAKEFOURCC('C', 'A', 'C', 'H');

[out] OptMethod

Méthode d’optimisation du maillage. Le pilote peut utiliser l’une des valeurs suivantes pour spécifier l’optimisation du maillage qu’il utilise.

[out] CacheSize

Taille effective, dans les entrées, pour laquelle le pilote optimise le cache de vertex. La taille réelle du cache n’est pas obligatoire pour être la taille spécifiée dans CacheSize , car la taille réelle du cache est supérieure dans la plupart des situations. Le pilote spécifie une taille optimisée dans CacheSize uniquement s’il spécifie également D3DXMESHOPT_VCACHE dans le membre OptMethod .

[out] MagicNumber

Nombre qui doit être utilisé dans le cadre d’une procédure d’essai et d’erreur lors de la détermination du moment où redémarrer la liste de bandes. Ce nombre peut être compris entre 1 et la valeur spécifiée dans le membre CacheSize . En règle générale, les meilleures valeurs sont proches de CacheSize/2. Le pilote spécifie un nombre dans MagicNumber uniquement s’il spécifie également D3DXMESHOPT_VCACHE dans le membre OptMethod .

Remarques

Runtime Direct3D version 9.0 et ultérieures. Le runtime Microsoft Direct3D appelle la fonction CreateQuery du pilote pour créer des ressources côté pilote pour la requête vertex-cache. Dans cet appel CreateQuery , le runtime spécifie le type de requête D3DDDIQUERYTYPE_VCACHE dans le membre QueryType de la structure D3DDDIARG_CREATEQUERY . Le pilote doit allouer une structure D3DDDIDEVINFO_VCACHE. Le runtime appelle ensuite la fonction IssueQuery du pilote pour traiter la requête vertex-cache. Le pilote doit insérer une instruction d’unité de traitement graphique (GPU) pour écrire les données du cache de vertex dans une allocation. Pour récupérer les informations du cache de vertex à partir du pilote, le runtime appelle la fonction GetQueryData du pilote. Dans cet appel GetQueryData , le pilote doit verrouiller l’allocation et retourner les données de vertex-cache au membre pData de la structure D3DDDIARG_GETQUERYDATA pointée vers le paramètre pData .

Runtime Direct3D version 8.1 uniquement. Le runtime Direct3D appelle la fonction GetInfo du pilote pour obtenir des informations de vertex-cache à partir du pilote. Dans cet appel GetInfo , le runtime transmet l’indicateur D3DDDIDEVINFOID_VCACHE dans le paramètre DevInfoID . Le pilote spécifie les informations de vertex-cache dans une structure de D3DDDIDEVINFO_VCACHE et les retourne au paramètre pDevInfoStruct .

Configuration requise

Voir aussi

CreateQuery

D3DDDIARG_CREATEQUERY

D3DDDIARG_GETQUERYDATA

GetInfo

GetQueryData

ProblèmeQuery