Метод 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, если драйвер не требует сведений.
Возвращаемое значение
Никакой
Замечания
Вызов GetDeviceIoControlParameters завершается ошибкой, если тип запроса не является типом элемента управления ввода-вывода устройства.
Хотя драйвер может дополнительно указать NULL для каждого из pControlCode, pInBufferSizeи параметра pOutBufferSize, драйвер должен указать по крайней мере один параметр, отличный от NULL, для GetDeviceIoControlParameters выполнить успешно.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |