clfsQueryLogFileInformation 函数 (wdm.h)

  • 项目

ClfsQueryLogFileInformation 例程返回指定 CLFS 流或其基础物理日志或两者兼有的元数据和状态信息。

语法

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

参数

[in] plfoLog

指向表示 CLFS 流的 LOG_FILE_OBJECT 结构的指针。 调用方之前通过调用 ClfsCreateLogFile 获取了此指针。

[in] eInformationClass

CLFS_LOG_INFORMATION_CLASS 枚举中的值，该值指定要请求的信息的类型。

pinfoInputBuffer

可选输入缓冲区，这是某些信息类所必需的。

cbinfoInputBuffer

pinfoInputBuffer 的长度（以字节为单位）。

[out] pinfoBuffer

指向接收日志信息的缓冲区的指针。 此缓冲区的结构取决于 eInformationClass 的值。 下表显示了信息类与缓冲区的数据类型之间的关系。

eInformationClass 的值 pinfoBuffer 指向的缓冲区类型
ClfsLogBasicInformation

CLFS_INFORMATION
ClfsLogBasicInformationPhysical

CLFS_INFORMATION
ClfsLogNameInformation

CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation

CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation

CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

传入信息缓冲区的长度（以字节为单位）。

返回值

ClfsQueryLogFileInformation 如果成功，则返回STATUS_SUCCESS;否则，它将返回 Ntstatus.h 中定义的错误代码之一。

注解

有关 CLFS 概念和术语的说明，请参阅 通用日志文件系统。

要求

要求 值
最低受支持的客户端 在 Windows Server 2003 R2、Windows Vista 和更高版本的 Windows 中可用。
目标平台 桌面
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另请参阅

ClfsSetLogFileInformation