Метод IWDFIoTarget::GetTargetFile (wudfddi.h)
Предупреждение
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 для объекта файла ввода-вывода.
Возвращаемое значение
Никакой
Замечания
Если объект файла платформы связан с целевым объектом ввода-вывода, платформа включает объект файла с запросами ввода-вывода, которые драйвер отправляет в целевой объект ввода-вывода.
Когда драйвер форматирует запрос ввода-вывода, целевой объект ввода-вывода позволяет драйверу использовать тот же файл, с которым был запущен запрос или новый файл.
Целевой объект ввода-вывода по умолчанию не имеет объекта файла, поэтому вызов GetTargetFile для целевого объекта ввода-вывода по умолчанию извлекает NULL.
Дополнительные сведения о целевых объектах ввода-вывода см. в разделе Использование целевых объектов ввода-вывода вUMDF.
Примеры
Пример кода использования метода GetTargetFile см. в разделеIWDFIoTarget::FormatRequestForWrite.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |