Создание файла с помощью целевого объекта USB-ввода-вывода

Предупреждение

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

Архивные примеры UMDF 1 можно найти в Windows 11, версия 22H2 — обновление драйверов за май 2022 года.

Дополнительные сведения см. в разделе Начало работы сUMDF.

Во время инициализации целевой объект USB-ввода-вывода создаёт объект файла внутри стека, который представляет собой сеанс по умолчанию, поддерживаемый целевым объектом USB-ввода-вывода открытым. Дополнительные сведения об объекте файла внутри стека см. в разделе "Создание объекта файла для обработки операций ввода-вывода". Целевой объект ввода-вывода USB или его дочерние целевые USB-каналы используют этот объект файла для отправки всех исходных операций ввода-вывода (например, ввода-вывода для получения дескриптора конфигурации USB).

Драйвер может использовать этот объект файла внутри стека в функциях форматирования (например, драйвер может передать указатель на этот объект файла параметру pFile в вызове метода IWDFIoTarget::FormatRequestForRead ), если драйвер должен отправить ввод-вывод в сеанс по умолчанию этого объекта файла. Чтобы получить объект файла внутри стека, драйвер может вызвать метод IWDFIoTarget::GetTargetFile .

Этот объект файла внутри стека закрывается, когда целевой объект ввода-вывода удаляется либо явным образом, когда драйвер вызывает метод IWDFObject::D eleteWdfObject в целевом объекте ввода-вывода или неявно, когда родительский объект ввода-вывода удаляется.

Если любой ввод-вывод остается невыполненным в этом объекте файла внутри стека во время удаления устройства, этот объект файла не будет закрыт, и UMDF создаст остановку драйвера. Дополнительные сведения см. в разделе Создание и использование объектов файлов, создаваемых драйвером.

  • Last updated on