Метод IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод GetCreateParametersEx получает параметры создания файла, связанные с файлом, который создается или открывается.
Синтаксис
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
Параметры
[out, optional] pOptions
Указатель на выделенную вызывающим переменную, которая получает битовые флаги, указывающие параметры создания файла. Эти флаги битов с именем FILE_XXXX определены в Wdm.h.
Низкие 24-разрядные значения переменной указывают, что параметры применяются при создании или открытии файла. Дополнительные сведения об этих битах см. в описании параметра CreateOptions функции ZwCreateFile.
Высокие восемь бит переменной указывают на действия для выполнения, если файл еще не существует. Дополнительные сведения об этих битах см. в описании параметра CreateDispositionZwCreateFile.
Этот параметр является необязательным и может быть null.
[out, optional] pFileAttributes
Указатель на выделенную вызывающим переменную, которая получает битовые флаги, указывающие атрибуты файла. Эти флаги битов с именем FILE_ATTRIBUTE_XXXX определены в Wdm.h. Дополнительные сведения об этих битовых флагах см. в описании параметра FileAttributesZwCreateFile.
Этот параметр является необязательным и может быть null.
[out, optional] pShareAccess
Указатель на выделенную вызывающим переменную, которая получает битовые флаги, указывающие параметры общего доступа к файлам. Эти флаги с именем FILE_SHARE_XXXX определяются в Wdm.h. Дополнительные сведения об этих битовых флагах см. в описании параметра ShareAccessZwCreateFile.
Этот параметр является необязательным и может быть null.
[out, optional] pDesiredAccess
Указатель на выделенную вызывающим ACCESS_MASK структуру, указывающую запрошенный доступ к файлу. Дополнительные сведения об этом параметре см. в параметре DesiredAccessZwCreateFile.
Этот параметр является необязательным и может быть null.
Возвращаемое значение
Никакой
Замечания
После вызова платформы функции обратного вызова IQueueCallbackCreate::OnCreateFile драйвер может вызывать метод IWDFIoRequest::GetCreateParameters или метод IWDFIoRequest2::GetCreateParametersEx для получения параметров создания файла.
Дополнительные сведения см. в разделе получение параметров для запросов ввода-вывода.
Примеры
В следующем примере кода показано, как функция обратного вызова IQueueCallbackCreate::OnCreateFile может получить интерфейс IWDFIoRequest2, а затем вызвать GetCreateParametersEx.
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.9 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |