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


IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

Удаляет с диска все аппаратные snapshot службы теневого копирования томов (VSS). Snapshot также называется теневой копией. Этот запрос доступен в Windows Vista и более поздних версиях операционных систем Windows. Вызывающий объект должен выполняться по адресу IRQL = PASSIVE_LEVEL.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Нет.

Длина входного буфера

Нет.

Выходной буфер

Нет.

Длина выходного буфера

Нет.

Блок состояния

Элемент Information имеет значение 0. Для элемента Status задано значение STATUS_SUCCESS, если операция была успешной. В противном случае элементу Status присваивается соответствующий код ошибки.

Комментарии

Этот код элемента управления вводом-выводом может быть выдан драйвером режима ядра или приложением в пользовательском режиме. Когда этот код элемента управления вводом-выводом выдается из драйвера в режиме ядра, вызывающий объект предоставляет пакет запроса ввода-вывода (IRP), содержащий IO_STATUS_BLOCK структуру данных. Эта структура данных используется для возврата информации об ошибке вызывающей объекту. Когда этот код элемента управления вводом-выводом выдается из приложения в пользовательском режиме с помощью подпрограммы DeviceIocontrol , вызывающий объект может получить сведения об ошибке, вызвав подпрограмму GetLastError .

Диск, дескриптор которого используется при выдаче этого IOCTL, может находиться в автономном состоянии при выдаче IOCTL. Если диск переводится в автономное состояние с помощью оснастки диспетчера дисков (MMC), на диске будет задан атрибут только для чтения, что приведет к сбою IOCTL. Однако если служебная программа секционирования диска (Diskpart.exe) используется для вывода диска в автономное состояние, атрибут только для чтения для диска не задан. По этой причине лучше всего использовать служебную программу раздела диска, чтобы поместить диск в автономное состояние.

Примечание Побочным эффектом использования этого IOCTL является то, что средства управления дисками могут сообщать о дополнительной секции типа UNKNOWN на дисках GPT. Эта секция размером 256 килобайт создается операцией IOCTL и является snapshot секцией, используемой в процессе восстановления. Этот раздел является ожидаемым и может быть проигнорирован системными администраторами.
 

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows Vista.
Верхняя часть ntdddisk.h (включая Ntdddisk.h)
IRQL PASSIVE_LEVEL