GetGestureInfo 函式 (winuser.h)
擷取具有手勢資訊的控制碼的 GESTUREINFO 結構。
語法
BOOL GetGestureInfo(
[in] HGESTUREINFO hGestureInfo,
[out] PGESTUREINFO pGestureInfo
);
參數
[in] hGestureInfo
手勢資訊控制碼。
[out] pGestureInfo
手勢資訊結構的指標。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請使用 GetLastError 函式。
備註
呼叫函式之前,必須先設定傳遞至函式之GESTUREINFO結構的cbSize成員。 否則, 對 GetLastError 的呼叫會以十進位) 傳回 ( 87 ERROR_INVALID_PARAMETER。 如果應用程式處理 WM_GESTURE 訊息,則會負責使用 CloseGestureInfoHandle關閉控制碼。 無法這麼做可能會導致進程記憶體流失。
如果訊息傳遞至 DefWindowProc,或使用 API 函式的其中一個 PostMessage 或 SendMessage 類別轉送,則控制碼會隨著訊息一起傳輸,而且應用程式不需要關閉。
範例
GESTUREINFO gestureInfo = {0};
gestureInfo.cbSize = sizeof(gestureInfo);
BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);
if (!bResult){
DWORD err = GetLastError();
}
規格需求
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-misc-l1-2-0 (于 Windows 8.1) |