PFND3DDDI_SETMARKERMODE fonction de rappel (d3dumddi.h)
Avertit le pilote d’affichage en mode utilisateur qu’il doit prendre en charge un type d’événement suivi d’événements pour l’événement de marqueur Windows (ETW). Éventuellement implémenté par le modèle de pilote d’affichage Windows (WDDM) 1.3 et versions ultérieures s’exécutant sur le matériel Microsoft Direct3D Level 9. (Consultez les conditions requises dans améliorations des performances de rendu Direct3D.) Pour un 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 de l’appareil 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 des mémoires tampons de commandes avec des informations d’événement personnalisées. Sinon, le pilote ne doit pas annoter les mémoires tampons de commande.
L’annotation peut être sous la forme d’une chaîne de texte dans les paramètres régionaux English-US, ou sous la forme d’une valeur d’index à 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
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 de D3DDDIMT_PROFILE :
- Utilisez une instrumentation légère qui ne produit pas de corrélation forte 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 placent une charge élevée des performances sur le pipeline graphique, telles que les commandes inactives d’attente. Pour pouvoir instrumenter les événements de marqueur de type profil, votre pilote ne doit pas avoir à vider le pipeline ou les caches.
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 |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3d10umddi.h) |