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