функция обратного вызова pHalExamineMBR (ntddk.h)

Статья
02/07/2025

Программа HalExamineMBR считывает главную загрузочную запись (MBR) диска и возвращает данные из MBR, если MBR имеет тип, указанный вызывающим средством.

Синтаксис

pHalExamineMBR Phalexaminembr;

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

Параметры

[in] DeviceObject

Указатель на объект устройства для проверяемого устройства.

[in] SectorSize

Минимальное количество байтов, которые операция ввода-вывода может получить от проверяемого устройства. Если это значение меньше 512, HalExamineMBR считывает 512 байт, чтобы убедиться, что она считывает всю таблицу секций.

[in] MBRTypeIdentifier

Идентификатор типа секции MBR. Этот параметр указывает тип MBR, который может находиться на диске. Дополнительные сведения см. в разделе "Примечания".

[out] Buffer

Указатель на расположение, в которое HalExamineMBR записывает указатель на буфер, содержащий данные из MBR. Макет буфера зависит от типа секции MBR. HalExamineMBR выделяет хранилище для этого буфера. Вызывающий объект должен освободить этот буфер как можно скорее, вызвав подпрограмму ExFreePool.

Наборы HalExamineMBR *буфера = NULL, если тип секции MBR диска не соответствует указанному MBRTypeIdentif ier или если возникла ошибка.

Возвращаемое значение

Никакой

Замечания

Список системных идентификаторов типов секций MBR см. в таблице PARTITION_INFORMATION. Эти идентификаторы определены в файле заголовка Ntdddisk.h.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows XP.
целевая платформа	Всеобщий
заголовка	ntddk.h (include Ntddk.h)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

См. также

ExFreePool

PARTITION_INFORMATION

Поделиться через