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

Статья
08/08/2023

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

Синтаксис

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

Параметры

[in, out] BootDiskInformation

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

[in] Size

Задает размер (в байтах) буфера, заданного параметром BootDiskInformation. Должен иметь значение sizeof(BOOTDISK_INFORMATION) или sizeof(BOOTDISK_INFORMATION_EX).

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также раздел

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

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

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