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。