Метод 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 бита этого параметра соответствуют параметру CreateOptionsZwCreateFile.
Этот параметр является необязательным. Драйвер может передать NULL, если драйвер не требует сведений.
[out, optional] pFileAttributes
Указатель на переменную, которая получает битовую маску флагов атрибутов, применяемую при создании или открытии файла, связанного с запросом. Явно указанные атрибуты применяются только при создании, замене файла или перезаписи в некоторых ситуациях. По умолчанию указывается один FILE_ATTRIBUTE_NORMAL флаг. Однако этот флаг можно переопределить любым другим флагом или побитовой комбинацией совместимых флагов ИЛИ. Битовая маска флагов атрибутов соответствует параметру FileAttributesZwCreateFile.
Этот параметр является необязательным. Драйвер может передать NULL, если драйвер не требует сведений.
[out, optional] pShareAccess
Указатель на переменную, получающую битовую маску флагов, которые указывают права доступа к общей папке, запрашиваемые для файла, связанного с запросом. Если полученная битовая маска равна нулю, запрашивается монопольный доступ. Дополнительные сведения об общем доступе см. в описании параметра ShareAccessZwCreateFile.
Этот параметр является необязательным. Драйвер может передать NULL, если драйвер не требует сведений.
Возвращаемое значение
Никакой
Замечания
Хотя драйвер может дополнительно указать NULL для каждого pOptions, pFileAttributesи параметры pShareAccess, драйвер должен указать по крайней мере один параметр, отличный отNULL для GetCreateParameters выполнить успешно.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |