Метод IWDFIoRequest::GetDeviceIoControlParameters (wudfddi.h)

  • Статья

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

Метод GetDeviceIoControlParameters извлекает параметры запроса для запроса типа управления ввода-вывода устройства.

Синтаксис

void GetDeviceIoControlParameters(
  [out] ULONG  *pControlCode,
  [out] SIZE_T *pInBufferSize,
  [out] SIZE_T *pOutBufferSize
);

Параметры

[out] pControlCode

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

Этот параметр является необязательным. Драйвер может передать значение NULL , если драйверу не требуются сведения.

[out] pInBufferSize

Указатель на переменную, которая получает размер (в байтах) входного буфера данных для запроса. Чтобы получить буфер входных данных, драйвер вызывает метод IWDFIoRequest::GetInputMemory .

Этот параметр является необязательным. Драйвер может передать значение NULL , если драйверу не требуются сведения.

[out] pOutBufferSize

Указатель на переменную, которая получает размер (в байтах) выходного буфера данных для запроса. Чтобы получить буфер выходных данных, драйвер вызывает метод IWDFIoRequest::GetOutputMemory .

Этот параметр является необязательным. Драйвер может передать значение NULL , если драйверу не требуются сведения.

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

None

Remarks

Вызов GetDeviceIoControlParameters завершается ошибкой , если тип запроса не является типом элемента управления ввода-вывода устройства.

Несмотря на то, что драйвер может указывать значение NULL для каждого из параметров pControlCode, pInBufferSize и pOutBufferSize , драйвер должен указать по крайней мере один параметр, отличный от NULL , для успешного выполнения GetDeviceIoControlParameters .

Требования

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

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

IWDFIoRequest

IWDFIoRequest::GetInputMemory

IWDFIoRequest::GetOutputMemory