DXGKDDI_SETPOINTERSHAPE回调函数 (d3dkmddi.h)

  • 项目

DxgkDdiSetPointerShape 函数设置鼠标指针的外观和位置。

语法

DXGKDDI_SETPOINTERSHAPE DxgkddiSetpointershape;

NTSTATUS DxgkddiSetpointershape(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETPOINTERSHAPE pSetPointerShape
)
{...}

参数

[in] hAdapter

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

[in] pSetPointerShape

指向描述鼠标指针外观和位置 的DXGKARG_SETPOINTERSHAPE 结构的指针。

返回值

DxgkDdiSetPointerShape 返回以下值之一：

返回代码 说明
STATUS_SUCCESS 鼠标指针已成功绘制。
STATUS_NO_MEMORY DxgkDdiSetPointerShape 无法分配完成它所需的内存。

注解

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

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

如果视频呈现的网络 (VidPN) 拓扑，该拓扑与 pSetPointerShape 参数指向的 DXGKARG_SETPOINTERSHAPE 结构的 VidPnSourceId 成员相关联，则不调用 DxgkDdiSetPointerShape。

应使 DxgkDdiSetPointerShape 可分页。

要求

要求 值
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 d3dkmddi.h
IRQL PASSIVE_LEVEL

另请参阅

DXGKARG_SETPOINTERSHAPE

DxgkDdiAddDevice

DxgkDdiSetPointerPosition