Метод 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 в режиме ядра.

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

Этот параметр является необязательным и может иметь значение NULL.

[out, optional] pFileAttributes

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

Этот параметр является необязательным и может иметь значение NULL.

[out, optional] pShareAccess

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

Этот параметр является необязательным и может иметь значение NULL.

[out, optional] pDesiredAccess

Указатель на структуру, выделенную вызывающим объектом, ACCESS_MASK , которая указывает запрошенный доступ к файлу. Дополнительные сведения об этом параметре см. в разделе Параметр DesiredAccessобъекта ZwCreateFile.

Этот параметр является необязательным и может иметь значение NULL.

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

None

Remarks

После того как платформа вызывает функцию обратного вызова 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 (включая Wudfddi.h)
DLL WUDFx.dll

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

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters