Funzione GetGestureInfo (winuser.h)
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) |