Метод IWDFIoRequest3::SetUserModeDriverInitiatedIo (wudfddi.h)

  • Статья

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

Метод SetUserModeDriverInitiatedIo

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

Синтаксис

void SetUserModeDriverInitiatedIo(
  [in] BOOL IsUserModeDriverInitiated
);

Параметры

[in] IsUserModeDriverInitiated

Логическое значение, которое, если значение TRUE, указывает, что запрос должен обрабатываться так, как если бы он был инициирован драйвером UMDF. Если значение РАВНО FALSE, этот параметр указывает, что запрос должен обрабатываться так, как если бы он поступил из приложения.

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

None

Remarks

Если драйвер UMDF вызывает этот метод с параметром IsUserModeDriverInitiated , установленным в значение TRUE, платформа устанавливает флаг IRP_UM_DRIVER_INITIATED_IO в элементе Flags структуры WDM IRP перед перенаправлением запроса драйверам режима ядра.

Драйвер в режиме ядра, расположенный под драйвером UMDF в том же стеке устройств, может проверка для этого флага, чтобы определить, следует ли обрабатывать запрос как инициированный драйвером UMDF.

Этот флаг не применим к драйверам режима ядра, которые могут получать запрос от драйвера UMDF через целевой объект ввода-вывода с дескриптором файлов или целевой объект ввода-вывода Win32.

Драйвер UMDF может задать для параметра IsUserModeDriverInitiated значение TRUE для запроса, поставляемого из приложения, если драйвер проверил запрос.

Запросы, созданные драйвером самостоятельно, уже помечены как полученные из драйвера UMDF.

Эквивалентом UMDF 2 этого метода является WdfRequestSetUserModeDriverInitiatedIo.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.11
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

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

GetUserModeDriverInitiatedIo

IWDFIoRequest3

WdfRequestSetUserModeDriverInitiatedIo