Función IoGetBootDiskInformation (wdm.h)
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 |
|---|---|
|
La rutina devolvió correctamente la información solicitada en el búfer especificado por BootDiskInformation. |
|
El valor de Tamaño es menor que el tamaño, en bytes, de una estructura de BOOTDISK_INFORMATION. |
|
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 IoGetBootDiskInformationy, a continuación, solo en sus rutinas de DriverEntry o AddDevice. |
Observaciones
solo un controlador de arranque puede llamar a IoGetBootDiskInformation. Este controlador debe llamar a ioGetBootDiskInformation en una rutina de devolución de llamada de reinicializar que registra el controlador llamando a la rutina de 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 BOOTDISK_INFORMATION_EX en el búfer de BootDiskInformation. De lo contrario, si tamaño es al menos tamaño de(BOOTDISK_INFORMATION), la rutina devuelve una estructura de BOOTDISK_INFORMATION.
En Windows 2000, la rutina devuelve solo la estructura BOOTDISK_INFORMATION.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | <= APC_LEVEL |