Метод 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 |