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

指定操作的控制代码。 视频微型端口驱动程序 I/O 控制代码中列出了 I/O 控件并完整描述了这些控件。

[in, optional] lpInBuffer

指向包含执行操作所需数据的缓冲区的指针。 如果控制代码指定的操作不需要输入数据,则此参数可以为 NULL

[in] nInBufferSize

指定 lpInBuffer 的大小(以字节为单位)。

[out, optional] lpOutBuffer

指向返回操作输出数据的缓冲区的指针。 如果控制代码指定的操作不生成输出数据,则此参数可以为 NULL

[in] nOutBufferSize

指定 lpOutBuffer 的大小(以字节为单位)。

[out] lpBytesReturned

指向 DWORD 的指针,该 DWORD 指定 在 lpOutBuffer 中返回的数据的实际大小(以字节为单位)。

返回值

返回值为 32 位 Win32 API 定义的错误代码。

注解

显示驱动程序使用 EngDeviceIoControl 将 I/O 请求传达给其相应的微型端口驱动程序。 此函数提供显示器和视频微型端口驱动程序之间的唯一信道。

要求

要求
最低受支持的客户端 在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

VIDEO_REQUEST_PACKET