funzione D3DPERF_BeginEvent

Articolo
06/13/2023

Contrassegna l'inizio di un evento definito dall'utente. PIX può usare questo evento per attivare un'azione.

Sintassi

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

Parametri

col

Colore dell'evento. Questo è il colore per visualizzare l'evento nella visualizzazione eventi.

wszName

Nome evento.

Valore restituito

Livello in base zero della gerarchia in cui inizia questo evento. Se si verifica un errore, il valore restituito sarà negativo.

Commenti

Gli eventi definiti dall'utente raggruppano altri eventi in modo significativo per il programma di destinazione in modo che possano essere rappresentati meglio negli strumenti di profilatura delle prestazioni. Ad esempio, un evento Draw Spaceship può includere una serie di chiamate Direct3D che gestiscono il disegno di una navicella spaziale in un gioco. Gli eventi possono essere annidati.

Ogni chiamata D3DPERF_BeginEvent deve avere una chiamata D3DPERF_EndEvent corrispondente. Gli eventi istantanei (che non includono altre parentesi) devono essere etichettati usando D3DPERF_SetMarker anziché D3DPERF_BeginEvent e D3DPERF_EndEvent.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d9.h
Libreria	d3d9.lib
DLL	d3d9.dll

Condividi tramite