structure DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Article
06/02/2025

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 valeur à utiliser dans un appel à la fonction pfnRenderCb.

Le pilote miniport d’affichage 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 la fonctionnalité Suivi des événements pour Windows (ETW).

PrivateDataSize

Taille, en octets, des données privées facultatives que le pilote stocke. Le pilote peut utiliser ces données à n’importe quelle fin.

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

Remarque Cette valeur doit être un multiple de 8 octets pour vous 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 du pilote privé ne sont pas journalisé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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1,WDDM 1.3 et versions ultérieures
serveur minimum pris en charge	Windows Server 2012 R2
d’en-tête	d3dkmddi.h (include D3dkmddi.h)

Voir aussi

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb

Partager via