GetPointerDevices 函式 (winuser.h)

  • 發行項

取得附加至系統之指標裝置的相關資訊。

語法

BOOL GetPointerDevices(
  [in, out]       UINT32              *deviceCount,
  [out, optional] POINTER_DEVICE_INFO *pointerDevices
);

參數

[in, out] deviceCount

如果 pointerDevices 為 Null， deviceCount 會傳回連接的指標裝置總數。 否則，deviceCount會指定pointerDevices所指向的POINTER_DEVICE_INFO結構數目。

[out, optional] pointerDevices

附加至系統的指標裝置 POINTER_DEVICE_INFO 結構的陣列。 如果為 Null，則會在 deviceCount中傳回附加指標裝置的總數。

傳回值

如果此函式成功，則會傳回 TRUE。

否則會傳回 FALSE。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError 函式。

備註

Windows 8 支援下列專案：

  • 每個指標裝置 256 個連絡人。
  • 不論連接的裝置數目為何，每個系統會話 2560 個連絡人總數。 例如，每個有 256 個連絡人的 10 個指標裝置、每個有 128 個連絡人的 20 個指標裝置等等。

規格需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (Windows 10 10.0.14393 版)

請參閱

函式