PFND3DWDDM1_3DDI_SETMARKERMODE fonction de rappel (d3d10umddi.h)

  • Article

Notifie le pilote d’affichage en mode utilisateur qu’il doit prendre en charge un type d’événement de marqueur de suivi d’événements pour Windows (ETW). Doit être implémenté par le modèle de pilote d’affichage Windows (WDDM) 1.3 et les pilotes ultérieurs.

Syntaxe

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

Paramètres

hDevice

Handle pour le périphérique d’affichage (contexte graphique).

Type

Valeur de l’énumération D3DWDDM1_3DDI_MARKER_TYPE qui indique le type d’événement de marqueur que le pilote doit prendre en charge.

Flags

Valeur UINT qui indique si le pilote doit fournir des informations personnalisées dans les mémoires tampons de commande. Si la valeur est D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, le pilote doit annoter et instrumenter les mémoires tampons de commande avec des informations d’événement personnalisées. Sinon, le pilote ne doit pas annoter les mémoires tampons de commande.

L’annotation peut se présenter sous la forme d’une chaîne de texte dans les paramètres régionaux anglais-États-Unis ou sous la forme d’une valeur d’index vers un emplacement dans une table de chaînes. Pour cette dernière option, le pilote doit également implémenter une fonction qui décrit les chaînes indiquées par les valeurs d’index.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur.

Suivez ces instructions lorsque vous configurez des événements de marqueur de type profil dans votre pilote en mode utilisateur, indiqués par le type D3DWDDM1_3DDI_MARKER_TYPE_PROFILE :

  • Utilisez une instrumentation légère qui ne produit pas de forte corrélation avec les limites des commandes graphiques.
  • Le pilote doit être en mesure d’échantillonner l’horodatage GPU à la fin du pipeline graphique.
  • N’utilisez pas de commandes d’échantillonnage qui imposent une charge de performances élevée au pipeline graphique, telles que les commandes d’attente inactives. Pour pouvoir instrumenter les événements de marqueur de type profil, votre pilote ne doit pas avoir à vider le pipeline ou les caches.

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
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3d10umddi.h (incluez D3d10umddi.h)

Voir aussi

D3DWDDM1_3DDI_MARKER_TYPE