DXGKDDI_SETPOINTERPOSITION回调函数 (d3dkmddi.h)

DxgkDdiSetPointerPosition 函数设置鼠标指针的位置和可见性状态。

语法

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

NTSTATUS DxgkddiSetpointerposition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERPOSITION pSetPointerPosition
)
{...}

参数

[in] hAdapter

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序以前向 MiniportDeviceContext 中的 Microsoft DirectX 图形内核子系统提供了此句柄,DxgkDdiAddDevice 函数的输出参数。

[in] pSetPointerPosition

指向 DXGKARG_SETPOINTERPOSITION 结构的指针,用于描述鼠标指针的位置和显示方式。

返回值

DxgkDdiSetPointerPosition 如果成功,则返回STATUS_SUCCESS;否则,它将返回 Ntstatus.h中定义的错误代码之一。

言论

DirectX 图形内核子系统调用显示微型端口驱动程序的 DxgkDdiSetPointerPosition 函数来设置鼠标指针的位置。 DxgkDdiSetPointerPosition 函数独立于所有其他显示微型端口驱动程序函数调用。 因此,DxgkDdiSetPointerPosition 线程可与另一个显示微型端口驱动程序线程同时运行。 但是,系统可确保 DxgkDdiSetPointerPositionDxgkDdiSetPointerShape 线程不能同时运行。

如果将 DxgkDdiSetPointerPosition 线程与另一个显示微型端口驱动程序线程同时运行,则显示微型端口驱动程序应能够独立于其他活动来编程鼠标指针硬件,例如通过直接内存访问(DMA)向图形硬件发送命令缓冲区的作、使用内存映射 I/O(MMIO)对图形硬件进行编程的作) 等等。

DxgkDdiSetPointerPosition,即使视频呈现网络(VidPN)拓扑与 VidPnSource Id 关联的 DXGKARG_SETPOINTERPOSITION 结构的成员(pSetPointerPosition 参数指向被禁用),也可以调用该拓扑。 在这种情况下,驱动程序应返回STATUS_SUCCESS但不应更改驱动程序或硬件的状态。

DxgkDdiSetPointerPosition 进行分页。

要求

要求 价值
最低支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h (包括 D3dkmddi.h)
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_SETPOINTERPOSITION

DxgkDdiAddDevice

DxgkDdiSetPointerShape