Функция IoWritePartitionTable (ntddk.h)

Статья
04/21/2023

Подпрограмма IoWritePartitionTableустарела и предоставляется только для поддержки существующих драйверов. Новые драйверы должны использовать IoWritePartitionTableEx.

IoWritePartitionTable записывает таблицы секций из записей в буфере списка секций для каждой секции на диске, представленной заданным объектом устройства.

Синтаксис

NTSTATUS IoWritePartitionTable(
  [in] PDEVICE_OBJECT            DeviceObject,
  [in] ULONG                     SectorSize,
  [in] ULONG                     SectorsPerTrack,
  [in] ULONG                     NumberOfHeads,
  [in] _DRIVE_LAYOUT_INFORMATION *PartitionBuffer
);

Параметры

[in] DeviceObject

Указатель на объект устройства, представляющий диск, таблицы разделов которого необходимо записать.

[in] SectorSize

Задает размер секторов на устройстве в байтах.

[in] SectorsPerTrack

Указывает размер дорожки на устройстве.

[in] NumberOfHeads

Указывает количество дорожек на цилиндр.

[in] PartitionBuffer

Указатель на буфер макета диска, содержащий записи списка секций. Дополнительные сведения см. в разделе DRIVE_LAYOUT_INFORMATION.

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

IoWritePartitionTablo возвращает код состояния STATUS_SUCCESS, если все операции записи были выполнены без ошибок. В случае сбоя коды ошибок, возвращаемые IoWritePartitionTable , могут включать, помимо прочего, следующий список:

Код возврата	Описание
STATUS_DEVICE_NOT_READY	Указывает на сбой при чтении правильной геометрии диска.
STATUS_INSUFFICIENT_RESOURCES	Указывает на сбой при выделении необходимых ресурсов (например, памяти кучи, IRP и т. д.).
STATUS_UNSUCCESSFUL	Указывает, что нулевой сектор не имеет ожидаемой сигнатуры диска MBR.

IoWritePartitionTable вызывается, когда драйвер дискового устройства запрашивается для задания типа секционирования в записи таблицы секций или повторного секционирования диска по запросу IRP_MJ_DEVICE_CONTROL. Запрос на управление устройством обычно отправляется служебной программой форматирования, которая выполняет функции управления вводом-выводом для разделов и дисков на компьютере.

Чтобы сбросить тип секции, драйвер передает указатель на объект устройства, представляющий физический диск, и номер раздела, связанного с объектом устройства, открытый программой форматирования. При динамическом повторном секционирование диска драйвер диска должен удалить набор объектов устройств, представляющих текущие разделы диска, и создать новый набор объектов устройств, представляющих новые разделы на диске.

Приложения, которые создают и удаляют секции и требуют полных описаний системы, должны вызывать IoReadPartitionTable с параметромReturnRecognizedPartitions со значением FALSE. Структуру макета диска можно изменить с помощью программы системного формата, чтобы отразить новую конфигурацию диска.

IoWritePartitionTable является синхронным. Он должен вызываться подпрограммой Dispatch драйвера диска или потоком драйвера. Таким образом, все потоки пользователя и файловой системы должны быть готовы к переходу в состояние ожидания при выдаче запроса на управление устройством для сброса типов секций для устройства.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntddk.h (включая Ntddk.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

См. также раздел

IoCreateDevice

IoReadPartitionTable

IoSetPartitionInformation