Метод IWDFIoTarget::FormatRequestForIoctl (wudfddi.h)

Статья
02/27/2024

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод FormatRequestForIoctl форматирует объект запроса ввода-вывода для операции управления вводом-выводом.

Синтаксис

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

Параметры

[in] pRequest

Указатель на интерфейс IWDFIoRequest для форматирования объекта запроса.

[in] IoctlCode

Управляющий код, определяющий определенную операцию для выполнения.

[in, optional] pFile

Указатель на интерфейс IWDFFile для объекта файла, связанного с запросом управления вводом-выводом. Для целевого объекта ввода-вывода по умолчанию этот параметр должен иметь значение, отличное от NULL.

[in, optional] pInputMemory

Указатель на интерфейс IWDFMemory , который используется для доступа к входной буферу для запроса. Этот параметр является необязательным.

[in, optional] pInputMemoryOffset

Указатель на структуру WDFMEMORY_OFFSET , описывающую смещение входной памяти для запроса. Этот параметр является необязательным.

[in, optional] pOutputMemory

Указатель на интерфейс IWDFMemory, используемый для доступа к выходному буферу для запроса. Этот параметр является необязательным.

[in, optional] pOutputMemoryOffset

Указатель на структуру WDFMEMORY_OFFSET , описывающую смещение выходной памяти для запроса. Этот параметр является необязательным.

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

FormatRequestForIoctl возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

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