D3DPERF_BeginEvent-Funktion

Artikel
06/13/2023

Markiert den Anfang eines benutzerdefinierten Ereignisses. PIX kann dieses Ereignis verwenden, um eine Aktion auszulösen.

Syntax

int WINAPI D3DPERF_BeginEvent(
  D3DCOLOR col,
  LPCWSTR wszName
);

Parameter

col

Ereignisfarbe. Dies ist die Farbe, in der das Ereignis in der Ereignisansicht angezeigt werden soll.

wszName

Ereignisname.

Rückgabewert

Die nullbasierte Ebene der Hierarchie, in der dieses Ereignis beginnt. Wenn ein Fehler auftritt, ist der Rückgabewert negativ.

Bemerkungen

Benutzerdefinierte Ereignisse gruppieren andere Ereignisse auf eine Weise, die für das Zielprogramm sinnvoll ist, damit sie in Leistungsprofilerstellungstools besser dargestellt werden können. Beispielsweise kann ein Draw Spaceship-Ereignis eine Reihe von Direct3D-Aufrufen in Klammern klammern, die das Zeichnen eines Raumschiffs in einem Spiel behandeln. Ereignisse können geschachtelt werden.

Jeder D3DPERF_BeginEvent Anruf sollte einen übereinstimmenden D3DPERF_EndEvent Anruf aufweisen. Sofortige Ereignisse (die andere Ereignisse nicht in Klammern klammern) sollten mithilfe von D3DPERF_SetMarker und nicht durch D3DPERF_BeginEvent und D3DPERF_EndEvent bezeichnet werden.

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d9.h
Bibliothek	d3d9.lib
DLL	d3d9.dll

Freigeben über