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)

請參閱

函式

手勢的程式設計指南