Функция EngDeviceIoControl (winddi.h)

  • Статья

Функция EngDeviceIoControl отправляет управляющий код указанному драйверу мини-порта видео, в результате чего устройство выполняет указанную операцию.

Синтаксис

ENGAPI DWORD EngDeviceIoControl(
  [in]            HANDLE  hDevice,
  [in]            DWORD   dwIoControlCode,
  [in, optional]  LPVOID  lpInBuffer,
  [in]            DWORD   nInBufferSize,
  [out, optional] LPVOID  lpOutBuffer,
  [in]            DWORD   nOutBufferSize,
  [out]           LPDWORD lpBytesReturned
);

Параметры

[in] hDevice

Дескриптор устройства, которое выполняет операцию.

[in] dwIoControlCode

Указывает код элемента управления для операции. Элементы управления вводом-выводом перечислены и подробно описаны в разделе Коды управления вводом-выводом драйвера Video Miniport.

[in, optional] lpInBuffer

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

[in] nInBufferSize

Задает размер lpInBuffer в байтах.

[out, optional] lpOutBuffer

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

[in] nOutBufferSize

Задает размер lpOutBuffer в байтах.

[out] lpBytesReturned

Указатель на DWORD, указывающий фактический размер данных, возвращаемых в lpOutBuffer, в байтах.

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

Возвращаемое значение представляет собой 32-разрядный код ошибки, определяемый API Win32.

Комментарии

EngDeviceIoControl используется драйвером дисплея для передачи запросов ввода-вывода соответствующему драйверу мини-порта. Эта функция предоставляет единственный канал связи между дисплеем и видеодрайдером минипорта.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

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

VIDEO_REQUEST_PACKET