Метод 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-terminated, содержащую имя файла для создания объекта файла. Этот параметр является необязательным. Драйвер может передать NULL если драйверу не нужно создать объект файла из имени файла. Если драйвер должен указать имя, строка, которую передает драйвер, не должна содержать символы разделителя путей ("/" или "\").
[out] ppFile
Указатель на буфер, который получает указатель на интерфейс IWDFDriverCreatedFile для объекта файла, созданного драйвером.
Возвращаемое значение
CreateWdfFile возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Замечания
Сведения о том, когда драйвер UMDF использует CreateWdfFile для обработки операций ввода-вывода, см. в статье Создание объекта файла для обработки ввода-вывода.
Сведения о том, когда драйвер UMDF может использовать CreateWdfFile, чтобы предотвратить несбалансированность создания и закрытия уведомлений драйверу, см. в статье Предотвращение дисбаланса создания и закрытия уведомлений надрайвера.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |