ReadFile function
从指定文件中读数据
Function:
int UAPI ReadFile(
int hFile,
bytes pBuffer,
int nSize
);
int UAPI ReadFile_s(
int hFile,
bytes pBuffer,
int nSize
);
Parameters:
- hFile [in]:文件句柄
- pBuffer [out]:读入缓冲区
- nSize [in]:读入大小
Return value:
- Type:int
- Text:成功返回实际读入文件大小(byte),失败返回 NULL
Remarks:
- 开发者应确保 pBuffer 参数所指定的缓冲区拥有足够的内存区域大小用于存放 nSize 参数指定大小所读入的数据,否则会导致内存溢出
- 开发者应使用 BytesSpace function 对 pBuffer 进行初始化
- 开发者可以使用 SDK 提供的更安全的 ReadFile_s function,以防止输入输出参数异常导致的应用程序崩溃或不可预知的后果。但 ReadFile_s function 的性能略低
- ReadFile_s function 为 SDK 中所导出的,在符号服务器 kext 中并不存在 ReadFile_s function
- 考虑到 ReadFile function 的执行性能因素,因此其采用最小化参数合法检查,开发者应确保其参数的正确性或使用 ReadFile_s function
Requirements:
| Keyword | Value |
|---|---|
| Minimum Agine Version | 171012.1 |
| Minimum SDK Version | 171012.1 |
| Header File | h.files |
| Library Server | kext |