structure DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Article
02/27/2024

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 de miniport d’affichage doit calculer cette valeur et l’entrer dans DXGK_HISTORY_BUFFER_HEADER avant d’appeler pfnRenderCb.

NumTimestamps

Nombre d’horodatages qui seront 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.

Note Cette valeur doit être un multiple de 8 octets pour garantir 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, alors lorsque le sous-système du noyau graphique DirectX écrit les 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, seront consignés dans ETW. Les données d’en-tête et de pilote privé ne sont pas enregistrées dans ETW dans le cadre de la mémoire tampon d’horodatage. Toutefois, certaines parties de l’en-tête seront journalisées séparément.

Configuration requise

Condition requise	Valeur
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 (inclure D3dkmddi.h)

Voir aussi

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb

Partager via