DXGKDDI_SETPOINTERPOSITION回调函数 (d3dkmddi.h)

项目
02/26/2024

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

语法

DXGKDDI_SETPOINTERPOSITION DxgkddiSetpointerposition;

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

参数

[in] hAdapter

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

[in] pSetPointerPosition

指向 DXGKARG_SETPOINTERPOSITION 结构的指针，用于描述在何处以及如何显示鼠标指针。

返回值

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

注解

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

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

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

应使 DxgkDdiSetPointerPosition 可分页。