PartyManager::SetProfilingCallbacksForMethodEntryExit

Konfiguriert optional die Profilerstellungsereignisrückrufe, die die Party-Bibliothek beim Aufrufen oder Beenden instrumentierter Methoden ausführt.

Syntax

PartyError SetProfilingCallbacksForMethodEntryExit(  
    PartyProfilingMethodEntranceCallback profilingMethodEntranceCallback,  
    PartyProfilingMethodExitCallback profilingMethodExitCallback  
)  

Parameter

profilingMethodEntranceCallback PartyProfilingMethodEntranceCallback
wahlfrei

Der Rückruf, der ausgeführt werden soll, wenn die Parteibibliothek in eine interne Methode eintritt, die für die Profilerstellung instrumentiert ist.

profilingMethodExitCallback PartyProfilingMethodExitCallback
wahlfrei

Der Rückruf, der ausgeführt werden soll, wenn die Parteibibliothek eine interne Methode verlässt, die für die Profilerstellung instrumentiert ist.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über GetErrorMessage() abgerufen werden.

Hinweise

Diese Methode ermöglicht es dem Titel, benutzerdefinierte Profilerstellungsrückruffunktionen zu installieren, um Leistungsmetriken der Partybibliothek in externen Profilerstellungstools aufzuzeichnen und zu visualisieren.

Diese Methode kann nur aufgerufen werden, wenn die Parteibibliothek nicht initialisiert ist. Das Aufrufen von während der Initialisierung von Party schlägt fehl und gibt einen Fehler zurück.

Das Festlegen eines optionalen Rückrufs auf gleich nullptr führt dazu, dass die Party-Bibliothek keine Profilerstellungsrückrufe für diesen Ereignistyp vorgibt.

Um die Auswirkungen der Profilerstellung auf die Titelleistung zu minimieren, sollten Rückrufe für diese Ereignisse so einfach wie möglich gehalten werden, da erwartet wird, dass sie hunderte oder tausende Male pro Sekunde ausgelöst werden.

Diese Methode wird nur für die Windows- und Microsoft Game Core-Versionen der Bibliothek unterstützt. Aufrufe auf anderen Plattformen schlagen fehl.

Anforderungen

Kopfball: Party.h

Weitere Informationen

PartyManager
PartyProfilingMethodEntranceCallback
PartyProfilingMethodExitCallback
PartyManager::GetProfilingCallbacksForMethodEntryExit