Função de retorno de chamada pHalExamineMBR (ntddk.h)

A rotina HalExamineMBR lê o MBR (registro de inicialização master) de um disco e retorna dados do MBR se o MBR for do tipo especificado pelo chamador.

Sintaxe

pHalExamineMBR Phalexaminembr;

void Phalexaminembr(
  [in]  PDEVICE_OBJECT DeviceObject,
  [in]  ULONG SectorSize,
  [in]  ULONG MBRTypeIdentifier,
  [out] PVOID *Buffer
)
{...}

Parâmetros

[in] DeviceObject

Um ponteiro para o objeto do dispositivo que está sendo examinado.

[in] SectorSize

O número mínimo de bytes que uma operação de E/S pode buscar do dispositivo que está sendo examinado. Se esse valor for menor que 512, HalExamineMBR lerá 512 bytes para garantir que ele leia uma tabela de partição inteira.

[in] MBRTypeIdentifier

Identificador de tipo de partição MBR. Esse parâmetro especifica o tipo de MBR que pode estar no disco. Para obter mais informações, consulte Comentários.

[out] Buffer

Um ponteiro para um local no qual HalExamineMBR grava um ponteiro em um buffer que contém dados do MBR. O layout do buffer depende do tipo de partição MBR. HalExamineMBR aloca o armazenamento para esse buffer. O chamador deve desalocar esse buffer o mais rápido possível chamando a rotina ExFreePool .

HalExamineMBR define *Buffer = NULL se o tipo de partição MBR do disco não corresponder ao especificado por MBRTypeIdentifier ou se houver um erro.

Retornar valor

Nenhum

Comentários

Para obter uma lista de identificadores de tipo de partição MBR definidos pelo sistema, consulte a tabela em PARTITION_INFORMATION. Esses identificadores são definidos no arquivo de cabeçalho Ntdddisk.h.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows XP.
Plataforma de Destino	Universal
Cabeçalho	ntddk.h (inclua Ntddk.h)
IRQL	PASSIVE_LEVEL
Regras de conformidade de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Confira também

ExFreePool

PARTITION_INFORMATION