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)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (於 Windows 10 10.0.14393 版)