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 ()