D3DPERF_BeginEvent fonction)
Marque le début d’un événement défini par l’utilisateur. PIX peut utiliser cet événement pour déclencher une action.
Syntaxe
int WINAPI D3DPERF_BeginEvent(
D3DCOLOR col,
LPCWSTR wszName
);
Paramètres
col
Couleur de l’événement. Il s’agit de la couleur permettant d’afficher l’événement dans l’affichage des événements.
wszName
Nom de l’événement.
Valeur retournée
Niveau de base zéro de la hiérarchie à partir duquel cet événement commence. Si une erreur se produit, la valeur de retour est négative.
Remarques
Les événements définis par l’utilisateur regroupent d’autres événements d’une manière significative pour le programme cible afin qu’ils puissent être mieux représentés dans les outils de profilage des performances. Par exemple, un événement d' espace de dessin peut comporter un certain nombre d’appels Direct3D qui gèrent le dessin d’un espace dans un jeu. Les événements peuvent être imbriqués.
Chaque appel de D3DPERF_BeginEvent doit avoir un appel de D3DPERF_EndEvent correspondant. Les événements instantanés (qui ne comportent pas d’autres événements) doivent être étiquetés à l’aide de D3DPERF_SetMarker plutôt que par D3DPERF_BeginEvent et D3DPERF_EndEvent.
Spécifications
| Plateforme cible | Windows |
| En-tête | d3d9. h |
| Bibliothèque | d3d9. lib |
| DLL | d3d9.dll |