Метод IWDFDevice::CreateWdfFile (wudfddi.h)

Статья
08/08/2023

[Предупреждение: 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 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

См. также раздел

IWDFDevice

IWDFDriverCreatedFile