GetTouchInputInfo-Funktion (winuser.h)
Ruft detaillierte Informationen zu Toucheingaben ab, die einem bestimmten Toucheingabehandle zugeordnet sind.
Syntax
BOOL GetTouchInputInfo(
[in] HTOUCHINPUT hTouchInput,
[in] UINT cInputs,
[out] PTOUCHINPUT pInputs,
[in] int cbSize
);
Parameter
[in] hTouchInput
Der Toucheingabehandle, der im LPARAM einer Touchnachricht empfangen wird. Die Funktion schlägt mit ERROR_INVALID_HANDLE fehl, wenn dieses Handle ungültig ist. Beachten Sie, dass das Handle ungültig ist, nachdem es in einem erfolgreichen Aufruf von CloseTouchInputHandle verwendet wurde oder nachdem es an DefWindowProc, PostMessage, SendMessage oder eine ihrer Varianten übergeben wurde.
[in] cInputs
Die Anzahl der Strukturen im pInputs-Array . Dies sollte im Idealfall mindestens der Anzahl der Berührungspunkte entsprechen, die der Nachricht zugeordnet sind, wie in der WPARAM-Nachricht angegeben. Wenn cInputs kleiner als die Anzahl der Touchpunkte ist, ist die Funktion weiterhin erfolgreich und füllt den pInputs-Puffer mit Informationen zu cInputs-Touchpunkten auf.
[out] pInputs
Ein Zeiger auf ein Array von TOUCHINPUT-Strukturen , um Informationen zu den Berührungspunkten zu erhalten, die dem angegebenen Toucheingabehandle zugeordnet sind.
[in] cbSize
Die Größe einer einzelnen TOUCHINPUT-Struktur in Bytes. Wenn cbSize nicht die Größe einer einzelnen TOUCHINPUT-Struktur aufweist, schlägt die Funktion mit ERROR_INVALID_PARAMETER fehl.
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
Durch das Aufrufen von CloseTouchInputHandle wird kein Arbeitsspeicher freigegeben, der mit Werten verknüpft ist, die in einem Aufruf von GetTouchInputInfo abgerufen wurden. Werte in Strukturen, die an GetTouchInputInfo übergeben werden, sind gültig, bis Sie sie löschen.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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) |