функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)

Статья
08/08/2023

[Относится к KMDF и UMDF]

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

Синтаксис

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in]  PCUNICODE_STRING           TargetDeviceName,
  [in]  ACCESS_MASK                DesiredAccess
);

Параметры

[out] Params

Указатель на структуру, выделенную драйвером WDF_IO_TARGET_OPEN_PARAMS , которую инициализирует функция.

[in] TargetDeviceName

Значение элемента TargetDeviceName структуры WDF_IO_TARGET_OPEN_PARAMS .

[in] DesiredAccess

Значение элемента DesiredAccess структуры WDF_IO_TARGET_OPEN_PARAMS .

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

None

Remarks

Если TargetDeviceName указывает имя уже существующего файла, система открывает существующий файл. Если файл не существует, операция открытия завершается ошибкой.

Структура WDF_IO_TARGET_OPEN_PARAMS используется в качестве входных данных для метода WdfIoTargetOpen .

Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME инициализирует элементы Size, Type, TargetDeviceName, DesiredAccess, CreateOptions и CreateDisposition указанной структуры WDF_IO_TARGET_OPEN_PARAMS .

KMDF Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME инициализирует элемент CreateDispositionдля FILE_OPEN.

UMDF Функция WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME инициализирует элемент CreateDispositionдля OPEN_EXISTING.

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

Примеры

Пример кода, в котором используется WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, см. в разделе WdfIoTargetOpen.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfiotarget.h (включая Wdf.h)
IRQL	Любой уровень