Função IoGetBootDiskInformation (wdm.h)

  • Artigo

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 pelo chamador que a rotina usa para retornar informações sobre a inicialização e os discos do sistema. A rotina preenche esse buffer com uma estrutura de BOOTDISK_INFORMATION ou BOOTDISK_INFORMATION_EX .

[in] Size

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

Retornar valor

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, apenas em suas rotinas DriverEntry ou AddDevice .

Comentários

IoGetBootDiskInformation só pode ser chamado por um driver de inicialização. Esse driver deve chamar IoGetBootDiskInformation em uma rotina de retorno de chamada Reinitializar que o driver registra chamando a rotina 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 Size for pelo menos sizeof(BOOTDISK_INFORMATION), a rotina retornará uma estrutura BOOTDISK_INFORMATION .

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

Requisitos

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

Confira também

BOOTDISK_INFORMATION

BOOTDISK_INFORMATION_EX

IoRegisterBootDriverReinitialization

Reinicializar