游戏引擎学习第15天

视频参考:https://www.bilibili.com/video/BV1mbUBY7E24
关于游戏中文件输入输出（IO）操作的讨论。主要分为两类：

只读资产的加载
- 这部分主要涉及游戏中用于展示和运行的只读资源，例如音乐、音效、美术资源（如 3D 模型和纹理）等。
- 这些文件从磁盘加载到内存中供游戏使用，但不会被修改。
- 在现代游戏中，这些数据可能非常庞大（数千兆字节），通常通过后台流式加载的方式避免加载屏幕过长，从而提升用户体验。
游戏状态的保存和加载
- 这部分与游戏配置和进度相关，例如窗口模式设置、声音音量设置、解锁状态、存档文件等。
- 这些文件既需要写入磁盘，也需要在后续运行时从磁盘中读取。
- 通常这些数据量相对较小，因此可以通过简单的平面调用加载，不需要复杂的流式处理。

文件的读写过程因数据类型和用途的不同有不同的处理方式：

只读资源需要注重性能优化（如流式加载），以避免影响游戏运行。
状态数据则关注正确性和持久性，确保配置和进度能在多次运行中保持一致。

在过去的开发中，文件操作通常是通过以下步骤完成的：

打开文件：
使用文件名调用 openFile 函数，获得文件句柄（file handle）。
读取文件内容：
提供一个缓冲区（如 128 字节），通过 read 函数从文件中读取指定字节的数据。
根据返回值判断读取是否成功，如果失败，需要处理错误。
关闭文件：
在操作完成后，清理文件句柄。

// 定义文件名为 "test.bmp"，指向字符串的指针
char *Filename = "test.bmp";// 打开文件并获取文件句柄
file_handle *File = OpenFile(Filename);// 定义一个大小为 128 字节的缓冲区
uint8 Buffer[128];// 尝试从文件中读取缓冲区大小的数据
if(Read(File, sizeof(Buffer), Buffer)) {// 如果读取成功，执行相应操作
} else {// 如果读取失败，执行失败处理逻辑
}// 关闭文件以释放资源
closeFile(File);

文件 I/O 操作的策略，特别是针对流式文件处理（streaming-based file I/O）是否适合某些目的进行了详细分析。以下是内容的要点总结和理解：

GetFileSize 是 Windows API 中用于获取文件大小的函数。

功能

返回指定文件的大小（以字节为单位）。

参数说明

hFile
- 输入参数，文件的句柄（HANDLE 类型）。
- 句柄必须是由支持文件读取的函数（如 CreateFile）返回的，且文件不能是管道。
lpFileSizeHigh
- 可选参数，指向一个 DWORD 类型的变量，用于存储文件大小的高 32 位（适用于大于 4GB 的文件）。
- 如果为 NULL，则忽略高 32 位。

返回值

成功
- 返回文件大小的低 32 位。
- 如果 lpFileSizeHigh 非空，则其指向的值存储文件大小的高 32 位。
失败
- 返回 INVALID_FILE_SIZE（0xFFFFFFFF）。
- 此时需要调用 GetLastError() 检查是否确实发生错误（如文件大小正好等于 INVALID_FILE_SIZE，不会返回错误）。

注意事项

对于超过 4GB 的文件，需要结合 lpFileSizeHigh 计算完整文件大小：
```
uint64_t fullFileSize = ((uint64_t)lpFileSizeHigh << 32) | fileSizeLow;
```
如果文件句柄不可读，函数会失败。

示例代码

#include <windows.h>
#include <stdio.h>int main() {// 打开文件HANDLE hFile = CreateFileA("example.txt",          // 文件路径GENERIC_READ,           // 读取权限0,                      // 不共享NULL,                   // 默认安全属性OPEN_EXISTING,          // 打开现有文件FILE_ATTRIBUTE_NORMAL,  // 普通文件属性NULL                    // 无模板文件);if (hFile == INVALID_HANDLE_VALUE) {printf("Failed to open file. Error: %lu\n", GetLastError());return 1;}// 获取文件大小DWORD fileSizeLow;DWORD fileSizeHigh;fileSizeLow = GetFileSize(hFile, &fileSizeHigh);if (fileSizeLow == INVALID_FILE_SIZE && GetLastError() != NO_ERROR) {printf("Failed to get file size. Error: %lu\n", GetLastError());CloseHandle(hFile);return 1;}// 计算完整文件大小uint64_t fullFileSize = ((uint64_t)fileSizeHigh << 32) | fileSizeLow;printf("File size: %llu bytes\n", fullFileSize);// 关闭句柄CloseHandle(hFile);return 0;
}

CloseHandle 是 Windows API 中用于关闭对象句柄的函数。

功能

关闭一个打开的句柄，释放与之关联的系统资源。

参数说明

hObject
- 输入参数，要关闭的句柄（HANDLE 类型）。
- 句柄可以是文件、线程、进程、同步对象（如互斥量、信号量）等。

返回值

成功
返回 TRUE。
失败
返回 FALSE。可以调用 GetLastError() 获取错误码以确定失败原因（例如句柄无效）。

注意事项

句柄无效时调用
如果传入的句柄已经被关闭或未初始化，会导致函数失败。
重复调用
不应多次关闭同一个句柄，否则可能导致程序异常。
文件句柄
文件操作完成后，必须调用 CloseHandle 关闭文件句柄以避免资源泄漏。
句柄类型
确保关闭的是正确类型的句柄，错误的操作可能会影响其他系统资源。

示例代码

#include <windows.h>
#include <stdio.h>int main() {// 打开文件HANDLE hFile = CreateFileA("example.txt",          // 文件路径GENERIC_READ,           // 读取权限0,                      // 不共享NULL,                   // 默认安全属性OPEN_EXISTING,          // 打开现有文件FILE_ATTRIBUTE_NORMAL,  // 普通文件属性NULL                    // 无模板文件);if (hFile == INVALID_HANDLE_VALUE) {printf("Failed to open file. Error: %lu\n", GetLastError());return 1;}printf("File opened successfully.\n");// 关闭文件句柄if (CloseHandle(hFile)) {printf("Handle closed successfully.\n");} else {printf("Failed to close handle. Error: %lu\n", GetLastError());}return 0;
}

用途

关闭文件、进程、线程、同步对象等句柄。
释放资源，防止资源泄漏或句柄耗尽。
适用于清理已完成的操作，保持程序高效运行。

常见场景

文件操作结束后调用。
线程或进程执行完毕后释放句柄。
锁或事件对象不再使用时销毁句柄。

用途

获取文件大小用于内存分配或文件操作。
确保文件未超出特定大小限制。
用于处理大文件时计算高低 32 位文件大小。

核心内容：

流式文件 I/O 不适用当前目标：
- 对于作者的特定目标，流式文件 I/O 并不合适，因为他们的需求是针对文件块的明确读取，而不是从一个大型流中逐块拉取数据。
- 他们需要读取的文件数据通常是固定大小的、可以预知的，不需要使用流的逐步处理。
当前需求是高效读取：
- 他们的重点是加载完整的文件或资产（例如加载一个完整的位图文件）。
- 读取操作是“全或无”，即一次性加载整个数据块，而非逐步处理。
未来可能的优化：
- 在目前开发阶段，他们选择简单直接的 I/O 操作策略，而不会为复杂流式操作进行过多优化。
- 将来，当需要加载一个打包的资源文件时（例如包含多个资产的文件），可以使用类似流式读取的系统，但需要支持多线程。
日志文件写入的例外：
- 唯一可能需要流式处理的场景是调试日志的写入，但目前并没有计划实现这一功能。

对比分析：

流式文件 I/O 的优势：
- 适用于处理超大文件或实时数据流的场景，比如从网络中逐步拉取视频数据。
- 资源占用较少（按需读取），避免一次性加载整个文件而导致内存压力。
当前策略的选择：
- 出于效率和简单性，作者选择直接一次性读取所需的文件块，而不是处理流式数据。这种方法适合加载固定大小、结构明确的文件内容。
未来策略的演变：
- 随着需求升级，例如加载复杂的打包资源，可能需要采用更高级的策略，比如使用多线程支持的分块流式读取。

关键总结：

当前任务：简单高效地加载文件，无需使用流式文件处理。
未来可能：在需要复杂的打包文件读取时，会考虑实现多线程和流式文件处理。
优化方向：现阶段优先选择易于实现的直接文件读取，而不是为复杂功能增加开发成本。
CreateFileA 是 Windows API 中用于创建、打开文件、设备、管道或通信资源的函数。其作用和用途如下：

功能

打开一个现有文件以进行读取、写入或两者操作。
创建一个新文件。
打开设备（如磁盘驱动器、控制台等）。
创建/打开管道或通信端口。

参数说明

lpFileName
指向一个以空字符结尾的字符串，表示文件或设备的路径名。
dwDesiredAccess
指定所需的访问模式（如读取、写入或两者）。常见值：
- GENERIC_READ: 读取访问权限
- GENERIC_WRITE: 写入访问权限
dwShareMode
指定文件或设备共享模式。常见值：
- FILE_SHARE_READ: 允许其他进程读取
- FILE_SHARE_WRITE: 允许其他进程写入
- 0: 不共享
lpSecurityAttributes
可选参数，指定安全属性。如果为 NULL，使用默认设置。
dwCreationDisposition
指定文件的行为，如是否创建新文件或覆盖现有文件。常见值：
- CREATE_NEW: 如果文件不存在，则创建；存在时失败
- CREATE_ALWAYS: 始终创建新文件（覆盖现有文件）
- OPEN_EXISTING: 打开现有文件，文件不存在时失败
- OPEN_ALWAYS: 打开文件，文件不存在时创建
- TRUNCATE_EXISTING: 打开文件并清空其内容
dwFlagsAndAttributes
指定文件或设备的标志和属性（如文件是否为隐藏或系统文件）。
hTemplateFile
可选参数，仅用于创建文件时，指定模板文件句柄。

返回值

成功：返回文件或设备的句柄（HANDLE 类型）。
失败：返回 INVALID_HANDLE_VALUE（可通过 GetLastError() 获取具体错误码）。

常见用途

打开文件进行读取或写入。
创建新的日志文件。
打开串口通信设备（如 COM1）。
操作管道或共享资源。

示例

HANDLE fileHandle = CreateFileA("example.txt",            // 文件路径GENERIC_READ | GENERIC_WRITE, // 读取和写入权限0,                        // 不共享NULL,                     // 默认安全属性CREATE_ALWAYS,            // 始终创建新文件FILE_ATTRIBUTE_NORMAL,    // 普通文件属性NULL                      // 不使用模板文件
);if (fileHandle == INVALID_HANDLE_VALUE) {printf("Failed to create or open file. Error: %lu\n", GetLastError());
} else {printf("File created/opened successfully.\n");CloseHandle(fileHandle); // 关闭文件句柄
}

ReadFile 是 Windows API 中用于从文件或 I/O 设备读取数据的函数。

功能

从文件或输入/输出设备（如文件、管道、串口等）中读取指定数量的字节数据到缓冲区。

参数说明

hFile
- 输入参数，文件或设备的句柄（HANDLE 类型）。
- 该句柄必须是由支持读取的函数（如 CreateFile）打开的，并具有读取权限。
lpBuffer
- 输出参数，指向一个缓冲区，用于存储读取到的数据。
- 如果此参数为 NULL，表示无效的缓冲区，函数将失败。
nNumberOfBytesToRead
- 输入参数，要读取的字节数。
- 指定读取操作期望完成的最大字节数。
lpNumberOfBytesRead
- 输出参数，指向一个变量，用于接收实际读取的字节数。
- 如果设置为 NULL，则调用方必须使用重叠（OVERLAPPED）结构处理字节计数。
lpOverlapped
- 输入/输出参数，指向一个 OVERLAPPED 结构，用于异步操作。
- 如果未使用异步操作，此参数必须为 NULL。

返回值

成功
- 返回 TRUE。
- *lpNumberOfBytesRead 包含实际读取的字节数。
失败
- 返回 FALSE。可以通过调用 GetLastError() 获取具体错误码。
- 如果读取操作被挂起（如使用异步操作），则错误码可能为 ERROR_IO_PENDING。

注意事项

同步与异步操作
- 如果句柄未设置为异步模式（如未指定 FILE_FLAG_OVERLAPPED），操作将以同步方式执行，函数在读取完成前不会返回。
- 如果句柄为异步模式，则必须提供 lpOverlapped，以便跟踪操作状态。
管道或设备的特殊性
- 对于管道或设备，ReadFile 的行为可能会根据数据可用性发生变化（如阻塞或非阻塞模式）。
缓冲区大小
- 确保 lpBuffer 有足够的大小存储 nNumberOfBytesToRead 字节数据。

示例代码

同步读取文件

#include <windows.h>
#include <stdio.h>int main() {// 打开文件HANDLE hFile = CreateFileA("example.txt",          // 文件路径GENERIC_READ,           // 读取权限0,                      // 不共享NULL,                   // 默认安全属性OPEN_EXISTING,          // 打开现有文件FILE_ATTRIBUTE_NORMAL,  // 普通文件属性NULL                    // 无模板文件);if (hFile == INVALID_HANDLE_VALUE) {printf("Failed to open file. Error: %lu\n", GetLastError());return 1;}// 读取文件内容char buffer[128] = {0};    // 缓冲区DWORD bytesRead = 0;       // 实际读取字节数if (ReadFile(hFile, buffer, sizeof(buffer) - 1, &bytesRead, NULL)) {printf("Read %lu bytes: %s\n", bytesRead, buffer);} else {printf("Failed to read file. Error: %lu\n", GetLastError());}// 关闭文件句柄CloseHandle(hFile);return 0;
}

用途

从文件中读取数据用于处理或存储。
从管道或串口读取输入数据。
结合异步 I/O 提高性能，处理多任务数据读取。

常见场景

文件数据解析。
读取串口通信内容。
处理日志或流数据。

VirtualAlloc 是 Windows API 中用于分配虚拟内存的函数。

功能

分配、保留或提交一个虚拟内存区域，并可设置该内存区域的访问权限。

参数说明

lpAddress
- 输入参数，指定内存区域的首地址（可选）。
- 如果为 NULL，系统将自动选择合适的地址。
- 如果非 NULL，则表示请求分配特定的地址，但需要符合内存对齐要求。
dwSize
- 输入参数，要分配的内存大小（以字节为单位）。
- 必须为系统页面大小（通常为 4KB）的倍数。
flAllocationType
- 输入参数，指定内存分配的类型。常见值：
  - MEM_COMMIT: 提交内存，分配实际的物理内存或交换文件空间。
  - MEM_RESERVE: 保留内存地址空间，但不分配物理内存。
  - MEM_RESET: 将指定内存标记为已重置，但保留其保留状态。
  - MEM_RESET_UNDO: 撤销 MEM_RESET 操作。
flProtect
- 输入参数，指定内存区域的访问保护类型。常见值：
  - PAGE_READONLY: 只读访问权限。
  - PAGE_READWRITE: 可读可写访问权限。
  - PAGE_EXECUTE: 可执行但不可读写权限。
  - PAGE_EXECUTE_READWRITE: 可执行、可读、可写权限。

返回值

成功
返回分配的内存区域的起始地址（LPVOID 类型）。
失败
返回 NULL。可以调用 GetLastError() 获取具体错误码。

注意事项

内存释放
- 使用 VirtualFree 释放通过 VirtualAlloc 分配的内存，避免内存泄漏。
内存类型
- 如果同时指定 MEM_COMMIT | MEM_RESERVE，表示既保留地址空间又提交内存。
页面大小对齐
- 分配的内存大小和地址必须符合页面大小对齐要求（通常为 4KB）。
分配失败
- 可能由内存不足、无效参数或地址冲突导致分配失败。

示例代码

分配和释放内存

#include <windows.h>
#include <stdio.h>int main() {// 分配 16KB 内存SIZE_T size = 16 * 1024; // 16KBLPVOID lpMemory = VirtualAlloc(NULL,               // 系统选择地址size,               // 分配大小MEM_COMMIT | MEM_RESERVE, // 提交和保留内存PAGE_READWRITE      // 可读可写权限);if (lpMemory == NULL) {printf("Memory allocation failed. Error: %lu\n", GetLastError());return 1;}printf("Memory allocated at address: %p\n", lpMemory);// 使用分配的内存char *data = (char *)lpMemory;for (int i = 0; i < size; i++) {data[i] = 'A';}printf("Memory written successfully.\n");// 释放内存if (!VirtualFree(lpMemory, 0, MEM_RELEASE)) {printf("Memory release failed. Error: %lu\n", GetLastError());return 1;}printf("Memory released successfully.\n");return 0;
}