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。 以下列表标识了可能的错误代码：

要求

另请参阅

CLFS_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

常见日志文件系统函数