PFND3DDDI_SETMARKERMODE fonction de rappel (d3dumddi.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). Implémenté éventuellement par les pilotes WDDM (Windows Display Driver Model) 1.3 et ultérieur s’exécutant sur le matériel Microsoft Direct3D Level 9. (Consultez la configuration requise dans Améliorations des performances de rendu Direct3D.) Pour du matériel plus avancé, les pilotes doivent implémenter la fonction SetMarkerMode .

Syntaxe

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

HRESULT Pfnd3dddiSetmarkermode(
  HANDLE hDevice,
  D3DDDI_MARKERTYPE Type,
  UINT Flags
)
{...}

Paramètres

hDevice

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

Type

Valeur de l’énumération D3DDDI_MARKERTYPE 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 D3DDDI_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 retournée

Retourne S_OK ou un résultat d’erreur approprié si la fonction ne se termine pas correctement.

Remarques

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 D3DDDIMT_PROFILE :

  1. Utilisez une instrumentation légère qui ne produit pas de forte corrélation avec les limites des commandes graphiques.
  2. Le pilote doit être en mesure d’échantillonner l’horodatage GPU à la fin du pipeline graphique.
  3. 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 d3dumddi.h (incluez D3d10umddi.h)

Voir aussi

D3DDDI_MARKERTYPE

SetMarkerMode