Función IoGetBootDiskInformation (wdm.h)

  • Artículo

La rutina IoGetBootDiskInformation devuelve información que describe los discos de arranque y del sistema.

Sintaxis

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

Parámetros

[in, out] BootDiskInformation

Puntero a un búfer asignado por el autor de la llamada que la rutina usa para devolver información sobre los discos de arranque y del sistema. La rutina rellena este búfer con una estructura de BOOTDISK_INFORMATION o de BOOTDISK_INFORMATION_EX .

[in] Size

Especifica el tamaño, en bytes, del búfer especificado por BootDiskInformation. Debe ser sizeof(BOOTDISK_INFORMATION) o sizeof(BOOTDISK_INFORMATION_EX).

Valor devuelto

IoGetBootDiskInformation devuelve uno de los siguientes valores de estado:

Código devuelto Descripción
STATUS_SUCCESS
 La rutina devolvió correctamente la información solicitada en el búfer especificado por BootDiskInformation.
STATUS_INVALID_PARAMETER
 El valor de Size es menor que el tamaño, en bytes, de una estructura de BOOTDISK_INFORMATION .
STATUS_TOO_LATE
 El controlador llamó a la rutina después de que el sistema ya se haya arrancado. Solo los controladores de arranque y del sistema pueden llamar a IoGetBootDiskInformation y, a continuación, solo en sus rutinas DriverEntry o AddDevice .

Comentarios

Solo un controlador de arranque puede llamar a IoGetBootDiskInformation. Este controlador debe llamar a IoGetBootDiskInformation en una rutina de devolución de llamada reinicializar que el controlador registra llamando a la rutina IoRegisterBootDriverReinitialization .

En Windows XP y versiones posteriores de Windows, si el parámetro Size es sizeof(BOOTDISK_INFORMATION_EX) o mayor, la rutina devuelve una estructura de BOOTDISK_INFORMATION_EX en el búfer BootDiskInformation . De lo contrario, si Size es al menos sizeof(BOOTDISK_INFORMATION), la rutina devuelve una estructura BOOTDISK_INFORMATION .

En Windows 2000, la rutina devuelve solo la estructura BOOTDISK_INFORMATION .

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Consulte también

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

Reinicializar