перечисление BPIO_OPERATIONS (ntddstor.h)

  • Статья

BPIO_OPERATIONS определяет различные операции BypassIO, поддерживаемые кодом элемента управления IOCTL_STORAGE_MANAGE_BYPASS_IO .

Синтаксис

typedef enum _BPIO_OPERATIONS {
  BPIO_OP_ENABLE,
  BPIO_OP_DISABLE,
  BPIO_OP_QUERY
} BPIO_OPERATIONS;

Константы

 
BPIO_OP_ENABLE
Запрашивает включение BypassIO для заданного тома или диска (устройства), что означает, что драйвер может не видеть все операции чтения и записи для этого стека.

ПРИМЕЧАНИЕ

Все драйверы в стеке томов и хранилищ имеют возможность наложить вето на запрос на включение BypassIO, но рекомендуется поддерживать его как можно больше.

На предварительном выполнении:

* Если драйвер может поддерживать BypassIO для данного устройства, он должен перенаправить запрос в стек.
* Если драйвер не может поддерживать BypassIO для данного устройства, он должен:
* Обновите структуру BPIO_OUTPUT , включая операцию NTSTATUS, описывающую, почему запрос на включение был наложен вето, имя драйвера и уникальную описательную строку с дополнительными сведениями о том, почему он нажал вето на запрос на включение.
* Выполните IOCTL_STORAGE_MANAGE_BYPASS_IO с помощью STATUS_SUCCESS.

Во время выполнения после операции драйвер может проверить, поддерживают ли все драйверы, приведенные ниже, в обход BypassIO. Если да, драйвер должен сохранить любое необходимое состояние для файла и продолжить обработку завершения. Драйвер отвечает за поддержание состояния для правильной обработки запросов, которые могут быть несовместимы с состоянием с поддержкой BypassIO.

Файловая система поддерживает число томов, сколько файлов в настоящее время включено BypassIO. Операция BPIO_OP_ENABLE отправляется только при переходе от нуля к единице.

Даже если драйвер тома или стека хранилища наложит вето на BypassIO, стек файловой системы может продолжать использовать BypassIO. Это связано с тем, что если кто-то наложил вето на BypassIO в стеке томов, файловая система по-прежнему может обходить фильтры.
BPIO_OP_DISABLE
Запрашивает отключение BypassIO для заданного тома или диска. Это позволяет драйверу очищать любое связанное состояние BypassIO.

Файловая система отправляет эту операцию при отключении или закрытии последнего файла с поддержкой BypassIO (количество его томов переходит от единицы к нулю).

Если драйвер получает BPIO_OP_DISABLE , но в настоящее время не включает BypassIO, он должен игнорировать запрос.

Эта операция не должна завершаться сбоем.
BPIO_OP_QUERY
Запрашивает, можно ли включить BypassIO для заданного тома или диска.

Драйвер хранилища должен обрабатывать этот запрос аналогично операции BPIO_OP_ENABLE , заполнив те же диагностические сведения в соответствующих полях структуры BPIO_OUTPUT . Основное отличие заключается в том, что драйвер не переходит в состояние BypassIO ENABLE во время запроса.

Комментарии

Дополнительные сведения см. в разделе BypassIO для драйверов хранилища .

Требования

Требование Значение
Минимальная версия клиента Windows 11
Верхняя часть ntddstor.h

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

IOCTL_STORAGE_MANAGE_BYPASS_IO