Funzione GetGestureInfo (winuser.h)

Articolo
08/27/2023

Recupera una struttura GESTUREINFO in base a un handle alle informazioni sui movimenti.

Sintassi

BOOL GetGestureInfo(
  [in]  HGESTUREINFO hGestureInfo,
  [out] PGESTUREINFO pGestureInfo
);

Parametri

[in] hGestureInfo

Handle di informazioni sul movimento.

[out] pGestureInfo

Puntatore alla struttura delle informazioni sui movimenti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

Il membro cbSize della struttura GESTUREINFO passato alla funzione deve essere impostato prima della chiamata della funzione. In caso contrario, le chiamate a GetLastError restituiranno ERROR_INVALID_PARAMETER (87 in decimale). Se un'applicazione elabora un messaggio di WM_GESTURE , è responsabile della chiusura dell'handle tramite CloseGestureInfoHandle. In caso contrario, potrebbero verificarsi perdite di memoria del processo.

Se il messaggio viene passato a DefWindowProc o viene inoltrato usando una delle classi PostMessage o SendMessage delle funzioni API, l'handle viene trasferito con il messaggio e non deve essere chiuso dall'applicazione.

Esempio


    GESTUREINFO gestureInfo = {0};
    gestureInfo.cbSize = sizeof(gestureInfo);
    BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);

    if (!bResult){                
        DWORD err = GetLastError();                                       
    }

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)

Vedi anche

Funzioni

Guida alla programmazione per i movimenti

Share via