getPointerInfo 函数 (winuser.h)

获取与当前消息关联的指定指针的信息。

注意 如果不需要 GetPointerInfo 公开的其他信息,请使用 GetPointerType
 

语法

BOOL GetPointerInfo(
  [in]  UINT32       pointerId,
  [out] POINTER_INFO *pointerInfo
);

参数

[in] pointerId

指针标识符。

[out] pointerInfo

接收指针信息的 POINTER_INFO 结构的地址。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

GetPointerInfo 检索与指针消息关联的单个指针的信息。

使用 GetPointerFrameInfo 检索与一组指针的消息关联的帧信息。

GetPointerInfo 返回的信息与调用线程检索到的最新指针消息相关联。 当调用线程检索下一条消息时,与上一条消息关联的信息可能不再可用。

如果应用程序处理指针输入消息的速度不像生成的那样快,则某些消息可能会合并为 WM_POINTERUPDATE 消息。 使用 GetPointerInfoHistory 从最近的 WM_POINTERUPDATE 消息检索消息历史记录。

如果与消息关联的信息不再可用,此函数将失败,最后一个错误设置为 ERROR_NO_DATA

如果调用线程不拥有指针消息已传递到的窗口,则此函数会失败,最后一个错误设置为 ERROR_ACCESS_DENIED。 请注意,这可能是最初向其传递输入的窗口,也可能是消息转发到的窗口。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.14393 中引入的 ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 ()

请参阅

函数

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory