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 Size 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 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 |