Метод IWDFDevice::CreateWdfFile (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]
Метод CreateWdfFile создает объект файла для использования драйвером.
Синтаксис
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Параметры
[in, optional] pcwszFileName
Указатель на строку, завершающуюся значением NULL, которая содержит имя файла для создания объекта файла. Этот параметр является необязательным. Драйвер может передать значение NULL , если драйверу не нужно создавать файловый объект на основе имени файла. Если драйвер должен указать имя, строка, которую передает драйвер, не должна содержать символы разделителя пути ("/" или "\").
[out] ppFile
Указатель на буфер, получающий указатель на интерфейс IWDFDriverCreatedFile для созданного драйвером объекта файла.
Возвращаемое значение
CreateWdfFile возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Комментарии
Сведения о том, когда драйвер UMDF использует CreateWdfFile для обработки ввода-вывода, см. в статье Создание файлового объекта для обработки ввода-вывода.
Сведения о том, когда драйвер UMDF может использовать CreateWdfFile для предотвращения несбалансированности уведомлений о создании и закрытии для драйвера, см. в разделе Предотвращение дисбаланса при создании и закрытии уведомлений для драйвера.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1.5 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |
| DLL | WUDFx.dll |