共用方式為

FSCTL_GET_BOOT_AREA_INFO控件程式代碼

  • 發行項

FSCTL_GET_BOOT_AREA_INFO控制程式代碼會擷取磁碟區開機扇區的位置。

若要執行這項作業，請使用下列參數呼叫 FltFsControlFile 函式或 ZwFsControlFile 函式。

參數

  • FileObject [in]： 僅限 FltFsControlFile 。 磁碟區的檔案物件指標 ，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]：輸出緩衝區的大小，以位元組為單位。

狀態區塊

FltFsControlFile 或 ZwFsControlFile 會傳回適當的 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.h 或 Fltkernel.h)

另請參閱

DeviceIoControl