UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
PlatformFileTrace.h
Go to the documentation of this file.
1// Copyright Epic Games, Inc. All Rights Reserved.
2
3#pragma once
4
5#include "CoreTypes.h"
6#include "Misc/Build.h"
7#include "Trace/Config.h"
8
9#if !UE_BUILD_SHIPPING
10#define PLATFORMFILETRACE_ENABLED 1
11#else
12#define PLATFORMFILETRACE_ENABLED 0
13#endif
14
15#if PLATFORMFILETRACE_ENABLED
16
18{
19 static CORE_API void BeginOpen(const TCHAR* Path);
20 static CORE_API void EndOpen(uint64 FileHandle);
21 static CORE_API void FailOpen(const TCHAR* Path);
24 static CORE_API void BeginClose(uint64 FileHandle);
25 static CORE_API void EndClose(uint64 FileHandle);
26 static CORE_API void FailClose(uint64 FileHandle);
27 static CORE_API void BeginRead(uint64 ReadHandle, uint64 FileHandle, uint64 Offset, uint64 Size);
28 static CORE_API void EndRead(uint64 ReadHandle, uint64 SizeRead);
29 static CORE_API void BeginWrite(uint64 WriteHandle, uint64 FileHandle, uint64 Offset, uint64 Size);
30 static CORE_API void EndWrite(uint64 WriteHandle, uint64 SizeWritten);
31
33};
34
35#define TRACE_PLATFORMFILE_BEGIN_OPEN(Path) \
36 FPlatformFileTrace::BeginOpen(Path);
37
38#define TRACE_PLATFORMFILE_END_OPEN(FileHandle) \
39 FPlatformFileTrace::EndOpen(uint64(FileHandle));
40
41#define TRACE_PLATFORMFILE_FAIL_OPEN(Path) \
42 FPlatformFileTrace::FailOpen(Path);
43
44#define TRACE_PLATFORMFILE_BEGIN_REOPEN(OldFileHandle) \
45 FPlatformFileTrace::BeginReOpen(uint64(OldFileHandle));
46
47#define TRACE_PLATFORMFILE_END_REOPEN(NewFileHandle) \
48 FPlatformFileTrace::EndReOpen(uint64(NewFileHandle));
49
50#define TRACE_PLATFORMFILE_BEGIN_CLOSE(FileHandle) \
51 FPlatformFileTrace::BeginClose(uint64(FileHandle));
52
53#define TRACE_PLATFORMFILE_END_CLOSE(FileHandle) \
54 FPlatformFileTrace::EndClose(uint64(FileHandle));
55
56#define TRACE_PLATFORMFILE_FAIL_CLOSE(FileHandle) \
57 FPlatformFileTrace::FailClose(uint64(FileHandle));
58
59#define TRACE_PLATFORMFILE_BEGIN_READ(ReadHandle, FileHandle, Offset, Size) \
60 FPlatformFileTrace::BeginRead(uint64(ReadHandle), uint64(FileHandle), Offset, Size);
61
62#define TRACE_PLATFORMFILE_END_READ(ReadHandle, SizeRead) \
63 FPlatformFileTrace::EndRead(uint64(ReadHandle), SizeRead);
64
65#define TRACE_PLATFORMFILE_BEGIN_WRITE(WriteHandle, FileHandle, Offset, Size) \
66 FPlatformFileTrace::BeginWrite(uint64(WriteHandle), uint64(FileHandle), Offset, Size);
67
68#define TRACE_PLATFORMFILE_END_WRITE(WriteHandle, SizeWritten) \
69 FPlatformFileTrace::EndWrite(uint64(WriteHandle), SizeWritten);
70
71#else
72
73#define TRACE_PLATFORMFILE_BEGIN_OPEN(Path)
74#define TRACE_PLATFORMFILE_END_OPEN(FileHandle)
75#define TRACE_PLATFORMFILE_BEGIN_REOPEN(OldFileHandle)
76#define TRACE_PLATFORMFILE_END_REOPEN(NewFileHandle)
77#define TRACE_PLATFORMFILE_FAIL_OPEN(Path)
78#define TRACE_PLATFORMFILE_BEGIN_CLOSE(FileHandle)
79#define TRACE_PLATFORMFILE_END_CLOSE(FileHandle)
80#define TRACE_PLATFORMFILE_FAIL_CLOSE(FileHandle)
81#define TRACE_PLATFORMFILE_BEGIN_READ(ReadHandle, FileHandle, Offset, Size)
82#define TRACE_PLATFORMFILE_END_READ(ReadHandle, SizeRead)
83#define TRACE_PLATFORMFILE_BEGIN_WRITE(WriteHandle, FileHandle, Offset, Size)
84#define TRACE_PLATFORMFILE_END_WRITE(WriteHandle, SizeWritten)
85
86#endif
FPlatformTypes::TCHAR TCHAR
Either ANSICHAR or WIDECHAR, depending on whether the platform supports wide characters or the requir...
Definition Platform.h:1135
FPlatformTypes::uint64 uint64
A 64-bit unsigned integer.
Definition Platform.h:1117
UE_FORCEINLINE_HINT TSharedRef< CastToType, Mode > StaticCastSharedRef(TSharedRef< CastFromType, Mode > const &InSharedRef)
Definition SharedPointer.h:127
uint32 Offset
Definition VulkanMemory.cpp:4033
uint32 Size
Definition VulkanMemory.cpp:4034
uint32_t uint32
Definition binka_ue_file_header.h:6
Definition PlatformFileTrace.h:18
static CORE_API void FailOpen(const TCHAR *Path)
static CORE_API void BeginWrite(uint64 WriteHandle, uint64 FileHandle, uint64 Offset, uint64 Size)
static CORE_API void FailClose(uint64 FileHandle)
static CORE_API void EndRead(uint64 ReadHandle, uint64 SizeRead)
static CORE_API void EndOpen(uint64 FileHandle)
static CORE_API void EndClose(uint64 FileHandle)
static CORE_API void EndWrite(uint64 WriteHandle, uint64 SizeWritten)
static CORE_API void BeginOpen(const TCHAR *Path)
static CORE_API uint32 GetOpenFileHandleCount()
static CORE_API void EndReOpen(uint64 NewFileHandle)
static CORE_API void BeginClose(uint64 FileHandle)
static CORE_API void BeginRead(uint64 ReadHandle, uint64 FileHandle, uint64 Offset, uint64 Size)
static CORE_API void BeginReOpen(uint64 OldFileHandle)