función D3DPERF_BeginEvent

Marca el principio de un evento definido por el usuario. PIX puede usar este evento para desencadenar una acción.

Sintaxis

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

Parámetros

col

Color del evento. Este es el color para mostrar el evento en la vista de eventos.

wszName

Nombre del evento.

Valor devuelto

Nivel de base cero de la jerarquía en la que se inicia este evento. Si se produce un error, el valor devuelto será negativo.

Observaciones

Los eventos definidos por el usuario agrupan otros eventos de una manera significativa para el programa de destino para que se puedan representar mejor en las herramientas de generación de perfiles de rendimiento. Por ejemplo, un evento Draw Spaceship podría corchete una serie de llamadas de Direct3D que controlan dibujar una nave espacial en un juego. Los eventos se pueden anidar.

Cada llamada D3DPERF_BeginEvent debe tener una llamada D3DPERF_EndEvent coincidente. Los eventos instantáneos (que no entre corchetes otros eventos) deben etiquetarse mediante D3DPERF_SetMarker en lugar de D3DPERF_BeginEvent y D3DPERF_EndEvent.

Requisitos

Plataforma de destino	Windows
Encabezado	d3d9.h
Library	d3d9.lib
Archivo DLL	d3d9.dll