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