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

IOCTL_DISK_RESET_SNAPSHOT_INFO IOCTL (ntdddisk.h)

  • Статья

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

Никакой.

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

Никакой.

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

Никакой.

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

Никакой.

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

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

Замечания

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

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows Vista.
заголовка ntdddisk.h (include Ntdddisk.h)
IRQL PASSIVE_LEVEL