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


Функция ZwCreateFile (wdm.h)

Подпрограмма ZwCreateFile создает новый файл или открывает существующий.

Синтаксис

NTSYSAPI NTSTATUS ZwCreateFile(
  [out]          PHANDLE            FileHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in]           POBJECT_ATTRIBUTES ObjectAttributes,
  [out]          PIO_STATUS_BLOCK   IoStatusBlock,
  [in, optional] PLARGE_INTEGER     AllocationSize,
  [in]           ULONG              FileAttributes,
  [in]           ULONG              ShareAccess,
  [in]           ULONG              CreateDisposition,
  [in]           ULONG              CreateOptions,
  [in, optional] PVOID              EaBuffer,
  [in]           ULONG              EaLength
);

Параметры

[out] FileHandle

Указатель на переменную HANDLE, которая получает дескриптор файла.

[in] DesiredAccess

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

флаг ACCESS_MASK Позволяет вызывающей абонентской службе сделать это
FILE_READ_DATA Чтение данных из файла.
FILE_READ_ATTRIBUTES Чтение атрибутов файла. (Дополнительные сведения см. в описании параметра FileAttributes .)
FILE_READ_EA Чтение расширенных атрибутов (EAs) файла. Этот флаг не имеет отношения к драйверам устройств и промежуточным драйверам.
FILE_WRITE_DATA Запись данных в файл.
FILE_WRITE_ATTRIBUTES Запишите атрибуты файла. (Дополнительные сведения см. в описании параметра FileAttributes .)
FILE_WRITE_EA Измените расширенные атрибуты (EAs) файла. Этот флаг не имеет отношения к драйверам устройств и промежуточным драйверам.
FILE_APPEND_DATA Добавление данных в файл.
FILE_EXECUTE Используйте системные операции ввода-вывода подкачки для чтения данных из файла в память. Этот флаг не имеет отношения к драйверам устройств и промежуточным драйверам.

Не указывайте FILE_READ_DATA, FILE_WRITE_DATA, FILE_APPEND_DATA или FILE_EXECUTE при создании или открытии каталога.

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

Универсальное право доступа Набор определенных прав доступа
GENERIC_READ STANDARD_RIGHTS_READ, FILE_READ_DATA, FILE_READ_ATTRIBUTES, FILE_READ_EA и SYNCHRONIZE.
GENERIC_WRITE STANDARD_RIGHTS_WRITE, FILE_WRITE_DATA, FILE_WRITE_ATTRIBUTES, FILE_WRITE_EA, FILE_APPEND_DATA и SYNCHRONIZE.
GENERIC_EXECUTE STANDARD_RIGHTS_EXECUTE, FILE_EXECUTE, FILE_READ_ATTRIBUTES и SYNCHRONIZE. Это значение не имеет отношения к драйверам устройства и промежуточным драйверам.
GENERIC_ALL FILE_ALL_ACCESS.

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

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

Флаг DesiredAccess Позволяет вызывающей абонентской службе сделать это
FILE_LIST_DIRECTORY Вывод списка файлов в каталоге.
FILE_TRAVERSE Обход каталога, иными словами, включите каталог в путь к файлу.

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

[in] ObjectAttributes

Указатель на структуру OBJECT_ATTRIBUTES , указывающую имя объекта и другие атрибуты. Используйте InitializeObjectAttributes для инициализации этой структуры. Если вызывающий объект не выполняется в контексте системного потока, он должен задать атрибут OBJ_KERNEL_HANDLE при вызове InitializeObjectAttributes.

[out] IoStatusBlock

Указатель на структуру IO_STATUS_BLOCK , которая получает окончательное состояние завершения и другие сведения о запрошенной операции. В частности, элемент Information получает одно из следующих значений:

  • FILE_CREATED

  • FILE_OPENED

  • FILE_OVERWRITTEN

  • FILE_SUPERSEDED

  • FILE_EXISTS

  • FILE_DOES_NOT_EXIST

[in, optional] AllocationSize

Указатель на LARGE_INTEGER, содержащий начальный размер выделения (в байтах) для созданного или перезаписываемого файла. Если параметр AllocationSize имеет значение NULL, размер выделения не указан. Если файл не создан или не перезаписан, allocationSize игнорируется.

[in] FileAttributes

Указывает один или несколько флагов FILE_ATTRIBUTE_XXX, которые представляют атрибуты файла, которые необходимо задать при создании или перезаписи файла. Вызывающий объект обычно указывает FILE_ATTRIBUTE_NORMAL, который задает атрибуты по умолчанию. Список допустимых флагов FILE_ATTRIBUTE_XXX см . в подпрограмме CreateFile . Если файл не создается или не перезаписывается, атрибуты FileAttributes игнорируются.

[in] ShareAccess

Тип доступа к общей папке, который указан как ноль, или любое сочетание следующих флагов.

Флаг ShareAccess Позволяет другим потокам делать это
FILE_SHARE_READ Чтение файла
FILE_SHARE_WRITE Запись файла
FILE_SHARE_DELETE Удаление файла

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

[in] CreateDisposition

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

Значение CreateDisposition Действие, если файл существует Действие, если файл не существует
FILE_SUPERSEDE Замените файл. Создайте файл.
FILE_CREATE Возвращает ошибку. Создайте файл.
FILE_OPEN Откройте файл. Возвращает ошибку.
FILE_OPEN_IF Откройте файл. Создайте файл.
FILE_OVERWRITE Откройте файл и перезапишите его. Возвращает ошибку.
FILE_OVERWRITE_IF Откройте файл и перезапишите его. Создайте файл.

[in] CreateOptions

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

Флаг CreateOptions Значение
FILE_DIRECTORY_FILE Файл является каталогом. Совместимые флаги CreateOptions : FILE_SYNCHRONOUS_IO_ALERT, FILE_SYNCHRONOUS_IO_NONALERT, FILE_WRITE_THROUGH, FILE_OPEN_FOR_BACKUP_INTENT и FILE_OPEN_BY_FILE_ID. Параметр CreateDisposition должен иметь значение FILE_CREATE, FILE_OPEN или FILE_OPEN_IF.
FILE_NON_DIRECTORY_FILE Файл не является каталогом. Открываемый объект file может представлять файл данных; логическое, виртуальное или физическое устройство; или том.
FILE_WRITE_THROUGH Системные службы, драйверы файловой системы и драйверы, которые записывают данные в файл, должны фактически передавать данные в файл, прежде чем любая запрошенная операция записи будет считаться завершенной.
FILE_SEQUENTIAL_ONLY Весь доступ к файлу будет последовательным.
FILE_RANDOM_ACCESS Доступ к файлу может быть случайным, поэтому драйверы файловой системы или система не должны выполнять последовательные операции упреждающего чтения.
FILE_NO_INTERMEDIATE_BUFFERING Файл не может быть кэширован или помещен во внутренние буферы драйвера. Этот флаг несовместим с флагом FILE_APPEND_DATA параметра DesiredAccess .
FILE_SYNCHRONOUS_IO_ALERT Все операции с файлом выполняются синхронно. Любое ожидание от имени звонящего зависит от преждевременного завершения оповещений. Этот флаг также приводит к тому, что система ввода-вывода будет поддерживать указатель позиции файла. Если этот флаг установлен, флаг SYNCHRONIZE должен быть установлен в параметре DesiredAccess .
FILE_SYNCHRONOUS_IO_NONALERT Все операции с файлом выполняются синхронно. Ожидания в системе, которые синхронизируют очередь ввода-вывода и завершение, не подлежат оповещениям. Этот флаг также заставляет систему ввода-вывода поддерживать контекст позиции файла. Если этот флаг установлен, флаг SYNCHRONIZE должен быть установлен в параметре DesiredAccess .
FILE_CREATE_TREE_CONNECTION Create подключение к дереву для этого файла, чтобы открыть его по сети. Этот флаг не используется драйверами устройств и промежуточными драйверами.
FILE_COMPLETE_IF_OPLOCKED Выполните эту операцию немедленно, используя альтернативный код успешного STATUS_OPLOCK_BREAK_IN_PROGRESS, если целевой файл заблокирован (oplock), а не блокирует поток вызывающего объекта. Если файл заблокирован, другой вызывающий объект уже имеет доступ к файлу. Этот флаг не используется драйверами устройств и промежуточными драйверами. Сведения об oplock см. в разделе Opportunistic Locks.
FILE_NO_EA_KNOWLEDGE Если расширенные атрибуты (EAs) для открываемого существующего файла указывают на то, что вызывающий объект должен понимать EAs для правильной интерпретации файла, ZwCreateFile должен вернуть ошибку. Этот флаг не имеет отношения к драйверам устройств и промежуточным драйверам.
FILE_OPEN_REPARSE_POINT Откройте файл с точкой повторного обработки и обйдите обычную обработку точек повторного обработки для файла. Дополнительные сведения см. в разделе "Примечания". Сведения о точке повторного анализа см. в разделе Точки повторного анализа.
FILE_DELETE_ON_CLOSE Система удаляет файл при передаче последнего дескриптора файла в ZwClose. Если этот флаг установлен, флаг DELETE должен быть установлен в параметре DesiredAccess .
FILE_OPEN_BY_FILE_ID Имя файла, указанное в параметре ObjectAttributes , включает в себя двоичный 8-байтовый или 16-байтовый номер ссылки на файл или идентификатор объекта для файла, в зависимости от файловой системы, как показано ниже. При необходимости имя устройства, за которым следует символ обратной косой черты, может продолжить эти двоичные значения. Например, имя устройства будет иметь следующий формат:

?? \C:\FileID
\device\HardDiskVolume1\ObjectID

Где FileID — 8 байт, а ObjectID — 16 байт.

В NTFS это может быть 8-байтовый или 16-байтовый номер ссылки или идентификатор объекта. 16-байтовое ссылочный номер совпадает с 8-байтным числом, заполненным нулями.

В ReFS это может быть 8-байтовый или 16-байтовый ссылочный номер. 16-байтовое число не связано с 8-байтным числом. Идентификаторы объектов не поддерживаются.

Файловые системы FAT, ExFAT, UDFS и CDFS не поддерживают этот флаг.

Этот номер присваивается и зависит от конкретной файловой системы.

Так как поле имени файла будет частично содержать двоичный BLOB-объект, неправильно предполагать, что это допустимая строка Юникода, и что более важно, может не быть строкой, завершающейся null.
FILE_OPEN_FOR_BACKUP_INTENT Файл открывается с целью резервного копирования. Поэтому система должна проверка определенные права доступа и предоставить вызывающему объекту соответствующий доступ к файлу, прежде чем проверять параметр DesiredAccess с дескрипторов безопасности файла. Этот флаг не используется устройствами и промежуточными драйверами.
FILE_RESERVE_OPFILTER Этот флаг позволяет приложению запрашивать оппортунистическую блокировку фильтра (oplock), чтобы предотвратить нарушения общей папки в других приложениях. Если дескрипторы уже открыты, запрос на создание завершится ошибкой с STATUS_OPLOCK_NOT_GRANTED. Дополнительные сведения см. в разделе "Примечания". Сведения об oplock см. в разделе Opportunistic Locks.
FILE_OPEN_REQUIRING_OPLOCK Файл открывается и запрашивается оппортунистическая блокировка (oplock) файла в виде одной атомарной операции. Файловая система проверяет наличие блокировок перед выполнением операции создания и завершится ошибкой создания с кодом возврата STATUS_CANNOT_BREAK_OPLOCK, если результатом будет прерывание существующей блокировки операции.

Флаг FILE_OPEN_REQUIRING_OPLOCK доступен в операционных системах Windows 7, Windows Server 2008 R2 и более поздних версий.
FILE_SESSION_AWARE Клиент, открывающий файл или устройство, учитывает сеанс, и при необходимости проверяется доступ к каждому сеансу.

Флаг FILE_SESSION_AWARE доступен, начиная с Windows 8.

[in, optional] EaBuffer

Для драйверов устройств и промежуточных драйверов этот параметр должен быть указателем NULL .

[in] EaLength

Для драйверов устройств и промежуточных драйверов этот параметр должен быть равен нулю.

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

ZwCreateFile возвращает STATUS_SUCCESS при успешном выполнении или соответствующий код ошибки NTSTATUS при сбое. В последнем случае вызывающий объект может определить причину сбоя, проверив параметр IoStatusBlock .

ZwCreateFile может возвращать STATUS_FILE_LOCK_CONFLICT в качестве возвращаемого значения или в элементе Statusструктуры IO_STATUS_BLOCK , на которую указывает параметр IoStatusBlock . Это происходит только в том случае, если файл журнала NTFS заполнен, а при попытке ZwCreateFile справиться с этой ситуацией возникает ошибка.

Комментарии

ZwCreateFile предоставляет дескриптор, который вызывающий объект может использовать для управления данными файла или состоянием и атрибутами объекта файла. Дополнительные сведения см. в разделе Использование файлов в драйвере.

Когда дескриптор, на который указывает FileHandle , перестанет использоваться, драйвер должен вызвать ZwClose , чтобы закрыть его.

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

Существует два альтернативных способа указать имя файла, который необходимо создать или открыть с помощью ZwCreateFile:

  1. В качестве полного имени пути, указанного в элементе ObjectName входного объекта ObjectAttributes.

  2. Значение pathname относительно файла каталога, представленного дескриптором в элементе RootDirectory входного объекта ObjectAttributes.

Установка определенных флагов в параметре DesiredAccess приводит к следующим последствиям:

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

  • Если вызывающий объект задает только флаги FILE_APPEND_DATA и SYNCHRONIZE, он может выполнять запись только в конец файла, а любые сведения о смещении операций записи в файл игнорируются. Файл будет автоматически расширен по мере необходимости для этого типа операции.

  • Установка флага FILE_WRITE_DATA для файла также позволяет вызывающей стороне выполнять запись за пределами конца файла. Опять же, файл автоматически расширяется по мере необходимости.

  • Если вызывающий объект задает только флаги FILE_EXECUTE и SYNCHRONIZE, он не может напрямую считывать или записывать данные в файл с помощью возвращенного fileHandle. То есть все операции с файлом выполняются через системный пейджер в ответ на инструкции и операции доступа к данным. Драйверы устройств и промежуточных драйверов не должны устанавливать флаг FILE_EXECUTE.

Параметр ShareAccess определяет, могут ли отдельные потоки получать доступ к одному файлу, возможно, одновременно. При условии, что у обоих вызывающих абонентов есть соответствующие права доступа, файл можно успешно открыть и предоставить к ним общий доступ. Если исходный вызывающий объект ZwCreateFile не указывает FILE_SHARE_READ, FILE_SHARE_WRITE или FILE_SHARE_DELETE, ни один другой вызывающий объект не может открыть файл, то есть исходному вызывающему объекту предоставляется монопольный доступ.

Чтобы успешно открыть общий файл, флаги DesiredAccess должны быть совместимы с флагами DesiredAccess и ShareAccess всех предыдущих открытых операций, которые еще не были выпущены через . То есть desiredAccess , указанный в ZwCreateFile для заданного файла, не должен конфликтовать с доступом, запрещенным другими средствами открытия файла.

Значение CreateDisposition FILE_SUPERSEDE требует, чтобы вызывающий объект был иметь доступ DELETE к существующему объекту файла. Если это так, успешный вызов ZwCreateFile с FILE_SUPERSEDE в существующем файле фактически удаляет этот файл, а затем повторно создает его. Это означает, что, если файл уже был открыт другим потоком, он открыл файл, указав параметр ShareAccess с флагом FILE_SHARE_DELETE. Обратите внимание, что этот тип ликвидации согласуется со стилем POSIX для перезаписи файлов.

Значения CreateDisposition FILE_OVERWRITE_IF и FILE_SUPERSEDE похожи. Если ZwCreateFile вызывается с существующим файлом и любое из этих значений CreateDisposition , файл будет заменен.

Перезапись файла семантически эквивалентна операции замены, за исключением следующих:

  • Вызывающий объект должен иметь доступ на запись к файлу, а не доступ к удалению. Это означает, что, если файл уже открыт другим потоком, он открыл файл с флагом FILE_SHARE_WRITE, установленным во входных данных ShareAccess.

  • Указанные атрибуты файла логически определяются вместе с атрибутами, уже имеющимися в файле. Это означает, что, если файл уже открыт другим потоком, последующий вызывающий объект ZwCreateFile не может отключить существующие флаги FileAttributes , но может включить дополнительные флаги для того же файла.

Значение FILE_DIRECTORY_FILE CreateOptions указывает, что создаваемый или открытый файл является каталогом. При создании файла каталога файловая система создает соответствующую структуру на диске, чтобы представлять пустой каталог для структуры на диске конкретной файловой системы. Если этот параметр был указан и данный файл, который необходимо открыть, не является файлом каталога или если вызывающий объект указал несогласованное значение CreateOptions или CreateDisposition , вызов ZwCreateFile завершится ошибкой.

Флаг createOptions FILE_NO_INTERMEDIATE_BUFFERING запрещает файловой системе выполнять промежуточную буферизацию от имени вызывающего объекта. Если указать этот флаг, параметры вызывающего объекта накладывают следующие ограничения на другие подпрограммы ZwXxxFile :

  • Любой необязательный параметр ByteOffset , передаваемый в ZwReadFile или ZwWriteFile, должен быть кратным размеру сектора.

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

  • Буферы должны быть выровнены в соответствии с требованиями выравнивания базового устройства. Чтобы получить эти сведения, вызовите ZwCreateFile , чтобы получить дескриптор для объекта файла, представляющего физическое устройство, и передайте этот дескриптор в ZwQueryInformationFile. Список системных значений FILE_XXX_ALIGNMENT см. в разделе DEVICE_OBJECT.

  • Вызовы ZwSetInformationFile с параметром FileInformationClass, для параметра FileInformationClass , равным FilePositionInformation, должны указывать смещение, кратное размеру сектора.

Флаги CreateOptions FILE_SYNCHRONOUS_IO_ALERT и FILE_SYNCHRONOUS_IO_NONALERT, которые являются взаимоисключающими, как следует из их названий, указывают, что все операции ввода-вывода с файлом будут синхронными, если они выполняются через объект file, на который ссылается возвращаемый FileHandle. Все операции ввода-вывода в таком файле сериализуются во всех потоках с помощью возвращенного дескриптора. Если установлен любой из этих флагов CreateOptions , необходимо также установить флаг SYNCHRONIZE DesiredAccess , чтобы заставить диспетчер ввода-вывода использовать файловый объект в качестве объекта синхронизации. В таких случаях диспетчер ввода-вывода отслеживает текущее смещение позиции файла, которое можно передать в ZwReadFile и ZwWriteFile. Вызовите ZwQueryInformationFile или ZwSetInformationFile , чтобы получить или задать эту позицию.

Если флаг createOptions FILE_OPEN_REPARSE_POINT не задан и ZwCreateFile пытается открыть файл с точкой повторного обработки, для файла выполняется обычная обработка точки повторного обработки. Если, с другой стороны, указан флаг FILE_OPEN_REPARSE_POINT, обычная обработка повторного обработки не выполняется и ZwCreateFile пытается открыть файл точки повторного обработки напрямую. В любом случае, если операция открытия прошла успешно, ZwCreateFile возвращает STATUS_SUCCESS; В противном случае подпрограмма возвращает код ошибки NTSTATUS. ZwCreateFile никогда не возвращает STATUS_REPARSE.

Флаг CreateOptions FILE_OPEN_REQUIRING_OPLOCK исключает время между открытием файла и запросом блокировки операции, которая потенциально может позволить третьей стороне открыть файл и получить нарушение общего доступа. Приложение может использовать флаг FILE_OPEN_REQUIRING_OPLOCK в ZwCreateFile , а затем запросить любой oplock. Это гарантирует, что владелец oplock будет уведомлен о любом последующем открытом запросе, который вызывает нарушение общего доступа.

В Windows 7, если в файле существуют другие дескрипторы, когда приложение использует флаг FILE_OPEN_REQUIRING_OPLOCK, операция создания завершится сбоем с STATUS_OPLOCK_NOT_GRANTED. Это ограничение больше не существует, начиная с Windows 8.

Если эта операция создания приведет к прерыванию блокировки операции, которая уже существует в файле, установка флага FILE_OPEN_REQUIRING_OPLOCK приведет к сбою операции создания с STATUS_CANNOT_BREAK_OPLOCK. Существующая блокировка не будет нарушена этой операцией создания.

Приложение, использующее флаг FILE_OPEN_REQUIRING_OPLOCK, должно запросить блокировку после успешного вызова, иначе все последующие попытки открыть файл будут заблокированы без обычной обработки блокировки. Аналогичным образом, если этот вызов завершается успешно, но последующий запрос oplock завершается ошибкой, приложение, использующее этот флаг, должно закрыть свой дескриптор после обнаружения сбоя запроса oplock.

Флаг FILE_OPEN_REQUIRING_OPLOCK доступен в операционных системах Windows 7, Windows Server 2008 R2 и более поздних версий. Файловые системы Майкрософт, реализующие этот флаг в Windows 7, — NTFS, FAT и exFAT.

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

  1. Отправьте запрос на создание с параметром CreateOptions FILE_RESERVE_OPFILTER, DesiredAccess точно FILE_READ_ATTRIBUTES и ShareAccess точно FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE.

    • Если дескрипторы уже открыты, запрос на создание завершается ошибкой с STATUS_OPLOCK_NOT_GRANTED, а следующая запрошенная блокировка также завершается ошибкой.

    • При открытии с большим доступом или меньшим общим доступом также произойдет сбой STATUS_OPLOCK_NOT_GRANTED.

  2. Если запрос на создание выполнен успешно, запросите блокировку операции.

  3. Откройте другой дескриптор файла для выполнения операций ввода-вывода.

Шаг 3 делает это практичным только для фильтров oplocks. Дескриптор, открытый на шаге 3, может иметь desiredAccess , который содержит не более FILE_READ_ATTRIBUTES | FILE_WRITE_ATTRIBUTES | FILE_READ_DATA | FILE_READ_EA | FILE_EXECUTE | SYNCHRONIZE | READ_CONTROL и по-прежнему не прерывает блокировку фильтра. Однако любой объект DesiredAccess больше FILE_READ_ATTRIBUTES | FILE_WRITE_ATTRIBUTES | Функция SYNCHRONIZE разорвёт блокировку на уровне 1 или пакетной службе и сделает флаг FILE_RESERVE_OPFILTER бесполезным для этих типов oplock.

NTFS — единственная файловая система Майкрософт, реализующая FILE_RESERVE_OPFILTER.

Вызывающие файлы ZwCreateFile должны выполняться по адресу IRQL = PASSIVE_LEVEL и с включенными специальными APC ядра.

Если вызов этой функции происходит в пользовательском режиме, следует использовать имя NtCreateFile вместо ZwCreateFile.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

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

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

ACCESS_MASK

DEVICE_OBJECT

IO_STATUS_BLOCK

InitializeObjectAttributes

Использование версий Nt и Zw собственных процедур системных служб

ZwClose

ZwOpenFile

ZwQueryInformationFile

ZwReadFile

ZwSetInformationFile

ZwWriteFile

 Оппортунистические блокировки

Точки повторного синтаксического анализа