feat(libSceRazorCpu): implement sceRazorCpuFlushOccurred

Co-Authored-By: Claude <noreply@anthropic.com>

core/libs/prx/libSceRazorCpu/Export.cpp

@@ -35,4 +35,9 @@ int APS5_VABI sceRazorCpuPopMarker(void) {
  return 0;
 }
 
+int APS5_VABI sceRazorCpuFlushOccurred(uint64_t* timeSpentInFlush) {
+ if (timeSpentInFlush != nullptr) *timeSpentInFlush = 0;
+ return 0;
+}
+
 }

core/libs/tests/GuestRazorCpu.cpp

@@ -9,6 +9,7 @@ int APS5_VABI sceRazorCpuJobManagerJob(const void* args);
 int APS5_VABI sceRazorCpuJobManagerSequence(const void* args);
 int APS5_VABI sceRazorCpuPushMarkerStatic(const char* name, std::uint32_t color, std::uint32_t flags);
 int APS5_VABI sceRazorCpuPopMarker(void);
+int APS5_VABI sceRazorCpuFlushOccurred(std::uint64_t* timeSpentInFlush);
 }
 
 namespace {
@@ -28,4 +29,8 @@ int main() {
     Require(sceRazorCpuPopMarker() == 0);
     Require(sceRazorCpuPushMarkerStatic("unbalanced", 0x80ffffffu, 2) == 0);
     Require(sceRazorCpuIsCapturing() == 0);
+    std::uint64_t timeSpentInFlush = 0x123456789abcdef0ull;
+    Require(sceRazorCpuFlushOccurred(&timeSpentInFlush) == 0);
+    Require(timeSpentInFlush == 0);
+    Require(sceRazorCpuFlushOccurred(nullptr) == 0);
 }

docs/dev/TechnicalDebt.md

@@ -102,6 +102,7 @@ Throughout the project, every function at every stage either **does exactly what
 - [sceAvPlayerStartEx](../../core/libs/prx/libSceAvPlayer/Export.cpp) (libSceAvPlayer) - start info layout unknown; it is ignored and playback starts as with `sceAvPlayerStart`
 - [sceAvPlayerInit / sceAvPlayerInitEx](../../core/libs/prx/libSceAvPlayer/src/Player.cpp) (libSceAvPlayer) - behaviour without a memory replacement unknown; frame and sample buffers then come from the guest heap
 - [SceAvPlayerVideoEx](../../core/libs/SceTypes.hpp) (libSceAvPlayer) - frame rate field and encoding unknown; it is left zero in frame and stream info
+- [sceRazorCpuFlushOccurred](../../core/libs/prx/libSceRazorCpu/Export.cpp) (libSceRazorCpu) - signature and return values (1 = flush since the last call, 0 = none) from [SharpProspero](https://github.com/SvenGDK/SharpProspero); without a capture nothing is flushed, so it returns 0 and writes 0 cycles to the optional out pointer (whether the real library writes it when nothing was flushed is unknown)
 - [sceRazorCpuPushMarkerStatic, sceRazorCpuPopMarker](../../core/libs/prx/libSceRazorCpu/Export.cpp) (libSceRazorCpu) - signatures from PPSA26344's calls; (name, color, flags) assumed for the push; both do nothing without a capture
 - [sceAjmDecMp3ParseFrame](../../core/libs/prx/libSceAjm.native/src/Ajm.cpp) (libSceAjm.native) - signature, result layout and rate tables taken from the [shadPS4](https://github.com/shadps4-emu/shadPS4) reimplementation of the PS4 library, not confirmed on a PS5 title: the layer field is not checked and MPEG-2.5 stops at 64 kbps; the original file length (`parse_ofl`) layout (Xing/Info + LAME tag, VBRI, Fraunhofer `0xB4` block with its CRC, encoder delay = samples per frame + LAME delay + 529) also comes from shadPS4 only, and the Fraunhofer block has no other public description
 - [sceAjmBatchJobGetCodecInfo, sceAjmBatchJobGetGaplessDecode](../../core/libs/prx/libSceAjm.native/src/Ajm.cpp) (libSceAjm.native) - the `RUN_GET_CODEC_INFO` flag (0x800), the ATRAC9 codec info layout and its next frame size are taken from the [shadPS4](https://github.com/shadps4-emu/shadPS4) and [RPCSX](https://github.com/RPCSX/rpcsx) reimplementations, not confirmed on a PS5 title; a run job without buffers returns result 0, as in shadPS4. The gapless sideband reports the total and skip counts the title set and does not count them down: RPCSX does the same, shadPS4 counts them down and BryKytyPS5 returns its current counts