Compartilhar via

função D3DPERF_BeginEvent

  • Artigo

Marca o início de um evento definido pelo usuário. O PIX pode usar esse evento para disparar uma ação.

Sintaxe

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

Parâmetros

col

Cor do evento. Essa é a cor para exibir o evento no modo de exibição de evento.

wszName

Nome do evento.

Valor retornado

O nível de base zero da hierarquia em que esse evento está começando. Se ocorrer um erro, o valor retornado será negativo.

Comentários

Os eventos definidos pelo usuário agrupam outros eventos de uma forma significativa para o programa de destino para que eles possam ser melhor representados nas ferramentas de criação de perfil de desempenho. Por exemplo, um evento Draw Spaceship pode agrupar várias chamadas direct3D que lidam com o desenho de uma nave espacial em um jogo. Os eventos podem ser aninhados.

Cada chamada D3DPERF_BeginEvent deve ter uma chamada de D3DPERF_EndEvent correspondente. Eventos instantâneos (que não agrupam outros eventos) devem ser rotulados usando D3DPERF_SetMarker e não por D3DPERF_BeginEvent e D3DPERF_EndEvent.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9.h
Biblioteca d3d9.lib
DLL d3d9.dll