Функция 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.
Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |