Метод IWDFIoRequest::GetCreateParameters (wudfddi.h)

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод GetCreateParameters извлекает параметры запроса для запроса типа создания.

Синтаксис

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

Параметры

[out, optional] pOptions

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

Высокие 8 бит этого параметра соответствуют параметру CreateDisposition функции ZwCreateFile в режиме ядра. Эти 8 бит определяют действие, выполняемое в зависимости от того, существует ли файл. Обратите внимание, что эти значения расположения отличаются от значений, используемых в параметре dwCreationDisposition функции Win32 CreateFile .

Низкие 24 бит этого параметра соответствуют параметру CreateOptionsобъекта ZwCreateFile.

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

[out, optional] pFileAttributes

Указатель на переменную, получающую битовую маску флагов атрибутов, которая применяется при создании или открытии файла, связанного с запросом. Явно указанные атрибуты применяются только при создании, замене или перезаписи файла. По умолчанию указывается один флаг FILE_ATTRIBUTE_NORMAL. Однако этот флаг можно переопределить любым другим флагом или побитовой комбинацией совместимых флагов ИЛИ. Битовая маска флагов атрибутов соответствует параметру FileAttributesобъекта ZwCreateFile.

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

[out, optional] pShareAccess

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

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

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

None

Remarks

Несмотря на то, что драйвер может указывать значение NULL для каждого из параметров pOptions, pFileAttributes и pShareAccess , драйвер должен указать по крайней мере один параметр, отличный от NULL , для успешного выполнения GetCreateParameters .

Требования

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

IWDFIoRequest

ZwCreateFile