getPointerPenInfo 函数 (winuser.h)

获取与当前消息关联的类型 PT_PEN) 的指定指针 (的基于笔的信息。

语法

BOOL GetPointerPenInfo(
  [in]  UINT32           pointerId,
  [out] POINTER_PEN_INFO *penInfo
);

[in] pointerId

要检索其信息的指针的标识符。

[out] penInfo

用于接收特定于笔的指针信息的 POINTER_PEN_INFO 结构的地址。

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

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

GetPointerPenInfo 检索与指针消息关联的PT_PEN ) 类型的单个指针 (的信息。

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

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

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

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

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

如果指定的指针不是 PT_PEN 类型，则此函数将失败，最后一个错误设置为 ERROR_DATATYPE_MISMATCH。