GetGestureInfo-Funktion (winuser.h)

  • Artikel

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)

Siehe auch

Funktionen

Programmierhandbuch für Gesten