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

另请参阅

CLFS_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

常见日志文件系统函数