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 dans laquelle cet événement démarre. Si une erreur se produit, la valeur de retour est négative.

Notes

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 Draw Spaceship peut mettre entre crochets un certain nombre d’appels Direct3D qui gèrent le dessin d’un vaisseau spatial dans un jeu. Les événements peuvent être imbriqués.

Chaque appel D3DPERF_BeginEvent doit avoir un D3DPERF_EndEvent appel correspondant. Les événements instantanés (qui ne crochetent 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