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

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

  • Статья

Подпрограмма 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

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