Функция WdfRequestSetUserModeDriverInitiatedIo (wdfrequest.h)

  • Статья

[Относится только к UMDF]

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

Синтаксис

void WdfRequestSetUserModeDriverInitiatedIo(
  [in] WDFREQUEST Request,
  [in] BOOLEAN    IsUserModeDriverInitiated
);

Параметры

[in] Request

Дескриптор объекта запроса платформы.

[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.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Целевая платформа Универсальное
Минимальная версия UMDF 2,0
Верхняя часть wdfrequest.h (включая Wdf.h)
Библиотека WUDFx02000.lib; WUDFx02000.dll
IRQL PASSIVE_LEVEL

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

WdfRequestGetUserModeDriverInitiatedIo