PFND3DDDI_SETMARKER fonction de rappel (d3dumddi.h)

Article
02/06/2025

Avertit le pilote d’affichage en mode utilisateur qu’il doit générer un nouvel horodatage si un travail GPU s’est terminé depuis le dernier appel à pfnSetMarker. É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 SetMarker.

Syntaxe

PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;

HRESULT Pfnd3dddiSetmarker(
  HANDLE hDevice
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

Valeur de retour

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

Remarques

Si le type d’événement de marqueur du paramètre Type de la fonction pfnSetMarkerMode n’est pas D3DDDIMT_NONE, le pilote d’affichage en mode utilisateur doit effectuer cette procédure avec chaque appel à pfnSetMarker:

Incrémentez la valeur du membre APISequenceNumber de la structure D3DDDICB_LOGUMDMARKER.
Déterminez les contextes associés à l’interface de pilote de périphérique à thread unique (DDI) qui sont envoyés fonctionnent avec le dernier appel à pfnSetMarker. Pour chaque contexte de ce type :
1. Si la mémoire tampon de commande pour le contexte est vide, ne faites rien.
2. Autrement:
  - Vérifiez que plus de mémoire est disponible dans la mémoire tampon d’historique du contexte. Videz la mémoire tampon si nécessaire.
  - Ajoutez une autre entrée à la mémoire tampon de numéro de séquence d’API du contexte qui contient les 32 bits faibles de la valeur APISequenceNumber actuelle.
  - Exemples et écriture d’horodatages appropriés pour le type d’événement de marqueur actuel.
3. Mettez à jour les données de suivi qui seront utilisées la prochaine fois que pfnSetMarker est appelée.

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)

Voir aussi

setMarker

pfnSetMarkerMode

Partager via