GetGestureInfo-Funktion (winuser.h)
Ruft eine GESTINFO-Struktur ab, die ein Handle für die Gesteninformationen erhält.
Syntax
BOOL GetGestureInfo(
[in] HGESTUREINFO hGestureInfo,
[out] PGESTUREINFO pGestureInfo
);
Parameter
[in] hGestureInfo
Das Gesteninformationshandle.
[out] pGestureInfo
Ein Zeiger auf die Gesteninformationsstruktur.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.
Hinweise
Das an die Funktion übergebene cbSize-Element der GESTUREINFO-Struktur muss festgelegt werden, bevor die Funktion aufgerufen wird. Andernfalls geben Aufrufe von GetLastErrorERROR_INVALID_PARAMETER (87 dezimal) zurück. Wenn eine Anwendung eine WM_GESTURE-Nachricht verarbeitet, ist sie dafür verantwortlich, das Handle mithilfe von CloseGestureInfoHandle zu schließen. Andernfalls kann es zu Speicherverlusten im Prozess kommen.
Wenn die Nachricht an DefWindowProc übergeben wird oder mithilfe einer der PostMessage- oder SendMessage-Klassen von API-Funktionen weitergeleitet wird, wird das Handle mit der Nachricht übertragen und muss nicht von der Anwendung geschlossen werden.
Beispiele
GESTUREINFO gestureInfo = {0};
gestureInfo.cbSize = sizeof(gestureInfo);
BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);
if (!bResult){
DWORD err = GetLastError();
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1) |