FSCTL_GET_BOOT_AREA_INFO控制代码

FSCTL_GET_BOOT_AREA_INFO控制代码检索卷的启动扇区的位置。

若要执行此操作,请使用以下参数调用 FltFsControlFile 函数或 ZwFsControlFile 函数。

参数

  • FileObject [in]: FltFsControlFile only. 卷的文件对象指针, FSCTL_GET_BOOT_AREA_INFO 将检索其启动信息。 此参数是必需的,不能为 NULL

  • FileHandle [in]: 仅 ZwFsControlFile 。 卷的文件句柄, FSCTL_GET_BOOT_AREA_INFO 将检索启动信息。 此参数是必需的,不能为 NULL

    必须使用SE_MANAGE_VOLUME_NAME访问权限打开此句柄。 有关详细信息,请参阅 文件安全性和访问权限

  • FsControlCode [in]:操作的控件代码。 对此操作使用 FSCTL_GET_BOOT_AREA_INFO

  • InputBuffer [in]:未与此操作一起使用。 设置为 NULL。

  • InputBufferLength [in]:未与此操作一起使用。 设置为零。

  • OutputBuffer [out]:指向 BOOT_AREA_INFO 结构的指针,该结构接收卷的启动扇区的位置。

  • OutputBufferLength [out]:输出缓冲区的大小(以字节为单位)。

状态块

FltFsControlFileZwFsControlFile 返回相应的 NTSTATUS 值,如以下值之一:

代码 含义
STATUS_SUCCESS 操作成功。 OutputBuffer 包含指向 BOOT_AREA_INFO 结构的指针。
STATUS_INVALID_PARAMETER 参数无效;例如,使用的句柄不是有效的卷句柄。
STATUS_BUFFER_TOO_SMALL OutputBuffer 对于结果不够大。 尚未将任何信息写入缓冲区。
STATUS_ACCESS_DENIED 用户没有SE_MANAGE_VOLUME访问权限。

注解

FSCTL_GET_BOOT_AREA_INFO 控制代码可用于 FastFAT 和 exFAT 设备。 此功能支持将 BitLocker 用于闪存驱动器等设备。

要求

要求类型 要求
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
标头 Ntifs.h (包括 Ntifs.hFltkernel.h)

请参阅

DeviceIoControl