getLogIoStatistics 函数 (clfsw32.h)
检索与指定句柄关联的专用日志或多路复用日志的日志 I/O 统计信息。 此函数查询通用日志文件系统 (CLFS) 以获取特定类型的日志 I/O 统计信息。 对多路复用日志调用此函数只会将统计信息与基础日志相关联。
语法
CLFSUSER_API BOOL GetLogIoStatistics(
[in] HANDLE hLog,
[in, out] PVOID pvStatsBuffer,
[in] ULONG cbStatsBuffer,
[in] CLFS_IOSTATS_CLASS eStatsClass,
[out, optional] PULONG pcbStatsWritten
);
参数
[in] hLog
CreateLogFile 获取的打开日志文件的句柄。 日志句柄可以引用专用或多路复用日志文件。
[in, out] pvStatsBuffer
指向用于接收 I/O 统计信息的缓冲区的指针。
此缓冲区必须至少与 I/O 统计信息数据包标头一样大。 有关详细信息,请参阅 CLFS_IO_STATISTICS_HEADER。
[in] cbStatsBuffer
I/O 统计信息缓冲区 pvStatsBuffer 的大小(以字节为单位)。
如果缓冲区不足以容纳统计信息数据包,则函数将失败并 ERROR_MORE_DATA。
[in] eStatsClass
此时未实现此参数;它保留供将来使用。
[out, optional] pcbStatsWritten
指向变量的指针,用于接收写入 pvStatsBuffer 的 I/O 统计信息数据包的大小。
此值小于或等于 cbStatsBuffer。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零 (0)。 要获得更多的错误信息,请调用 GetLastError。 以下列表标识了可能的错误代码:
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | clfsw32.h |
Library | Clfsw32.lib |
DLL | Clfsw32.dll |