Метод IWDFIoTarget::GetTargetFile (wudfddi.h)

Статья
08/08/2023

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

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

Метод GetTargetFile извлекает объект файла платформы, связанный с целевым объектом ввода-вывода.

Синтаксис

void GetTargetFile(
  [out] IWDFFile **ppWdfFile
);

Параметры

[out] ppWdfFile

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

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

None

Remarks

Если объект файла платформы связан с целевым объектом ввода-вывода, платформа включает файловый объект с запросами ввода-вывода, которые драйвер отправляет в целевой объект ввода-вывода.

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

Целевой объект ввода-вывода по умолчанию не имеет объекта file, поэтому вызов GetTargetFile для целевого объекта ввода-вывода по умолчанию получает значение NULL.

Дополнительные сведения о целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода в UMDF.

Примеры

Пример кода использования метода GetTargetFile см. в разделе IWDFIoTarget::FormatRequestForWrite.

Требования

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

Поделиться через