Функция IoGetBootDiskInformation (wdm.h)

Статья
02/07/2025

Программа IoGetBootDiskInformation возвращает сведения, описывающие загрузочные и системные диски.

Синтаксис

NTSTATUS IoGetBootDiskInformation(
  [in, out] PBOOTDISK_INFORMATION BootDiskInformation,
  [in]      ULONG                 Size
);

Параметры

[in, out] BootDiskInformation

Указатель на выделенный вызывающим буфером, который подпрограмма использует для возврата сведений о загрузочных и системных дисках. Подпрограмма заполняет этот буфер как BOOTDISK_INFORMATION, так и структурой BOOTDISK_INFORMATION_EX.

[in] Size

Указывает размер буфера, указанного BootDiskInformation. Должен быть размер(BOOTDISK_INFORMATION) или размер(BOOTDISK_INFORMATION_EX).

Возвращаемое значение

IoGetBootDiskInformation возвращает одно из следующих значений состояния:

Возвращаемый код	Описание
STATUS_SUCCESS	Подпрограмма успешно вернула запрошенные сведения в буфере, указанном BootDiskInformation.
STATUS_INVALID_PARAMETER	Значение Размер меньше размера в байтах структуры BOOTDISK_INFORMATION.
STATUS_TOO_LATE	Драйвер вызвал подпрограмму после того, как система уже загрузилась. Только драйверы загрузки и системы могут вызывать IoGetBootDiskInformation, а затем только в программах DriverEntry или AddDevice.

Замечания

IoGetBootDiskInformation можно вызывать только драйвером загрузки. Этот драйвер должен вызывать IoGetBootDiskInformation в подпрограмме обратного вызова повторной инициализации, которую регистрирует драйвер, вызвав подпрограмму IoRegisterBootBootDriverReinitialization.

В Windows XP и более поздних версиях Windows, если параметр размераразмер(BOOTDISK_INFORMATION_EX) или больше, подпрограмма возвращает структуру BOOTDISK_INFORMATION_EX в буфере BootDiskInformation. В противном случае, если размер не менее размер(BOOTDISK_INFORMATION), подпрограмма возвращает структуру BOOTDISK_INFORMATION.

В Windows 2000 подпрограмма возвращает только BOOTDISK_INFORMATION структуру.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 2000.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

повторно инициализация

Поделиться через