Метод 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, этот параметр указывает, что запрос должен рассматриваться как будто он поступил из приложения.
Возвращаемое значение
Никакой
Замечания
Если драйвер 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 (include Wudfddi.h) |
| DLL | WUDFx.dll |