structure DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Spécifie la façon dont les données sont stockées dans une mémoire tampon d’historique DXGK_HISTORY_BUFFER .

Syntaxe

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Membres

RenderCbSequence

Valeur du D3DDDICB_RENDERFLAGS. Membre de valeur à utiliser dans un appel à la fonction pfnRenderCb .

Le pilote d’affichage miniport doit calculer cette valeur et l’entrer dans DXGK_HISTORY_BUFFER_HEADER avant d’appeler pfnRenderCb.

NumTimestamps

Nombre d’horodatages qui se trouveront dans la mémoire tampon d’historique lorsque la mémoire tampon DMA termine son exécution.

Le pilote doit inclure tous les horodatages enregistrés, même si la mémoire tampon doit être mise en forme avant d’être journalisée dans l’installation de suivi des événements pour Windows (ETW).

PrivateDataSize

Taille, en octets, de données privées facultatives stockées par le pilote. Le pilote peut utiliser ces données à des fins quelconques.

Si zéro, le pilote n’a pas besoin de stocker les données privées dans la mémoire tampon d’historique.

Note Cette valeur doit être un multiple de 8 octets pour s’assurer que les données d’horodatage sont alignées sur une limite 64 bits.
 
Si la mémoire tampon d’historique n’a pas besoin d’être mise en forme lorsque la mémoire tampon DMA termine son exécution, lorsque le sous-système du noyau graphique DirectX écrit des journaux dans ETW, il utilise PrivateDataSize comme décalage direct de l’en-tête pour référencer les horodatages.

Reserved

Réservé à l’utilisation du système et doit être défini sur zéro.

Remarques

Seule la partie horodatage de la mémoire tampon d’historique, ainsi que le nombre d’horodatages, sera journalisée dans ETW. Les données d’en-tête et les données de pilote privé ne sont pas enregistrées dans ETW dans le cadre de la mémoire tampon d’horodatage. Toutefois, les parties de l’en-tête sont journalisées séparément.

Spécifications

   
Client minimal pris en charge Windows 8.1,WDDM 1.3 et versions ultérieures
Serveur minimal pris en charge Windows Server 2012 R2
En-tête d3dkmddi.h (include D3dkmddi.h)

Voir aussi

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb