Функция GetPointerInfo (winuser.h)
Возвращает сведения для указанного указателя, связанного с текущим сообщением.
Синтаксис
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 |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (появилось в Windows 10, версия 10.0.14393) |