Função IoGetBootDiskInformation (wdm.h)

Artigo
02/07/2025

A rotina IoGetBootDiskInformation retorna informações que descrevem os discos de inicialização e sistema.

Sintaxe

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

Parâmetros

[in, out] BootDiskInformation

Ponteiro para um buffer alocado por chamador que a rotina usa para retornar informações sobre os discos de inicialização e sistema. A rotina preenche esse buffer com um BOOTDISK_INFORMATION ou uma estrutura BOOTDISK_INFORMATION_EX.

[in] Size

Especifica o tamanho, em bytes, do buffer especificado por BootDiskInformation. Deve ser tamanhos de(BOOTDISK_INFORMATION) ou tamanhos de(BOOTDISK_INFORMATION_EX).

Valor de retorno

IoGetBootDiskInformation retorna um dos seguintes valores de status:

Código de retorno	Descrição
STATUS_SUCCESS	A rotina retornou com êxito as informações solicitadas no buffer especificado por BootDiskInformation.
STATUS_INVALID_PARAMETER	O valor de Size é menor que o tamanho, em bytes, de uma estrutura BOOTDISK_INFORMATION.
STATUS_TOO_LATE	O driver chamou a rotina depois que o sistema já foi inicializado. Somente drivers de inicialização e sistema podem chamar IoGetBootDiskInformation e, em seguida, somente em suas rotinas de DriverEntry ou AddDevice.

Observações

IoGetBootDiskInformation só pode ser chamado por um driver de inicialização. Esse driver deve chamar IoGetBootDiskInformation em um reinicializar rotina de retorno de chamada que o driver registra chamando a rotina de IoRegisterBootDriverReinitialization.

No Windows XP e versões posteriores do Windows, se o parâmetro Size for sizeof(BOOTDISK_INFORMATION_EX) ou maior, a rotina retornará uma estrutura BOOTDISK_INFORMATION_EX no buffer BootDiskInformation. Caso contrário, se Tamanho for pelo menos tamanhos de(BOOTDISK_INFORMATION), a rotina retornará uma estrutura BOOTDISK_INFORMATION.

No Windows 2000, a rotina retorna apenas a estrutura BOOTDISK_INFORMATION.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 2000.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Consulte também

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

reinicializar

Compartilhar via