POINTER_INFO-Struktur (winuser.h)
Enthält grundlegende Zeigerinformationen, die allen Zeigertypen gemeinsam sind. Anwendungen können diese Informationen mithilfe der Funktionen GetPointerInfo, GetPointerFrameInfo, GetPointerInfoHistory und GetPointerFrameInfoHistory abrufen.
Syntax
typedef struct tagPOINTER_INFO {
POINTER_INPUT_TYPE pointerType;
UINT32 pointerId;
UINT32 frameId;
POINTER_FLAGS pointerFlags;
HANDLE sourceDevice;
HWND hwndTarget;
POINT ptPixelLocation;
POINT ptHimetricLocation;
POINT ptPixelLocationRaw;
POINT ptHimetricLocationRaw;
DWORD dwTime;
UINT32 historyCount;
INT32 InputData;
DWORD dwKeyStates;
UINT64 PerformanceCount;
POINTER_BUTTON_CHANGE_TYPE ButtonChangeType;
} POINTER_INFO;
Member
pointerType
Typ: POINTER_INPUT_TYPE
Ein Wert aus der POINTER_INPUT_TYPE-Enumeration , der den Zeigertyp angibt.
pointerId
Typ: UINT32
Ein Bezeichner, der einen Zeiger während seiner Lebensdauer eindeutig identifiziert. Ein Zeiger entsteht, wenn er zum ersten Mal erkannt wird, und beendet seine Existenz, wenn er außerhalb des Erkennungsbereichs liegt. Beachten Sie, dass eine physische Entität (Finger oder Stift) aus dem Erkennungsbereich ausfällt und dann wieder erkannt wird, als neuer Zeiger behandelt und möglicherweise einem neuen Zeigerbezeichner zugewiesen wird.
frameId
Typ: UINT32
Ein Bezeichner, der mehreren Zeigern gemeinsam ist, für die das Quellgerät ein Update in einem einzelnen Eingabeframe gemeldet hat. Beispielsweise kann ein Multitouch-Digitalisierer im parallelen Modus die Positionen mehrerer Touchkontakte in einem einzigen Update an das System melden.
Beachten Sie, dass der Framebezeichner als Eingabe für alle Zeiger auf allen Geräten an das System gemeldet wird. Daher enthält dieses Feld möglicherweise keine streng sequenziellen Werte in einer einzelnen Reihe von Nachrichten, die ein Fenster empfängt. Dieses Feld enthält jedoch den gleichen numerischen Wert für alle Eingabeupdates, die von einem einzelnen Gerät im gleichen Eingaberahmen gemeldet wurden.
pointerFlags
Typ: POINTER_FLAGS
Kann eine vernünftige Kombination von Flags aus den Zeigerflagskonstanten sein.
sourceDevice
Typ: HANDLE
Behandeln Sie das Quellgerät, das in Aufrufen der Roheingabegeräte-API und der Digitizergeräte-API verwendet werden kann.
hwndTarget
Typ: HWND
Fenster, auf das diese Nachricht ausgerichtet wurde. Wenn der Zeiger erfasst wird, entweder implizit aufgrund eines Kontakts über dieses Fenster oder explizit mithilfe der Zeigererfassungs-API, ist dies das Erfassungsfenster. Wenn der Zeiger nicht gekapselt ist, ist dies das Fenster, über das sich der Zeiger befand, als diese Nachricht generiert wurde.
ptPixelLocation
Typ: POINT
Die vorhergesagten Bildschirmkoordinaten des Zeigers in Pixeln.
Der vorhergesagte Wert basiert auf der vom Digitizer gemeldeten Zeigerposition und der Bewegung des Zeigers. Diese Korrektur kann visuelle Verzögerung aufgrund inhärenter Verzögerungen bei der Erfassung und Verarbeitung der Zeigerposition auf dem Digitizer kompensieren. Dies gilt für Zeiger vom Typ PT_TOUCH. Bei anderen Zeigertypen ist der vorhergesagte Wert mit dem nicht vorhergesagten Wert identisch (siehe ptPixelLocationRaw).
ptHimetricLocation
Typ: POINT
Die vorhergesagten Bildschirmkoordinaten des Zeigers in HIMETRIC-Einheiten.
Der vorhergesagte Wert basiert auf der vom Digitizer gemeldeten Zeigerposition und der Bewegung des Zeigers. Diese Korrektur kann visuelle Verzögerung aufgrund inhärenter Verzögerungen bei der Erfassung und Verarbeitung der Zeigerposition auf dem Digitizer kompensieren. Dies gilt für Zeiger vom Typ PT_TOUCH. Bei anderen Zeigertypen ist der vorhergesagte Wert mit dem nicht vorhergesagten Wert identisch (siehe ptHimetricLocationRaw).
ptPixelLocationRaw
Typ: POINT
Die Bildschirmkoordinaten des Zeigers in Pixeln. Angepasste Bildschirmkoordinaten finden Sie unter ptPixelLocation.
ptHimetricLocationRaw
Typ: POINT
Die Bildschirmkoordinaten des Zeigers in HIMETRIC-Einheiten. Angepasste Bildschirmkoordinaten finden Sie unter ptHimetricLocation.
dwTime
Art: DWORD
0 oder der Zeitstempel der Nachricht, basierend auf der Anzahl von System-Häkchen beim Empfang der Nachricht.
Die Anwendung kann den Eingabezeitstempel entweder in dwTime oder PerformanceCount angeben. Der Wert darf nicht aktueller als die aktuelle Tickanzahl oder der QueryPerformanceCount -Wert (QPC) des Einschleusungsthreads sein. Sobald ein Frame mit einem Zeitstempel eingefügt wurde, müssen alle nachfolgenden Frames einen Zeitstempel enthalten, bis alle Kontakte im Frame in den UP-Zustand wechseln. Der benutzerdefinierte Zeitstempelwert muss auch für das erste Element im Kontaktearray angegeben werden. Die Zeitstempelwerte nach dem ersten Element werden ignoriert. Der benutzerdefinierte Zeitstempelwert muss in jedem Einschleusungsrahmen inkrementiert werden.
Wenn PerformanceCount angegeben wird, wird der Zeitstempel bei der tatsächlichen Einschleusung in die aktuelle Zeit in einer Auflösung von 1 Millisekunden konvertiert. Wenn ein benutzerdefinierter PerformanceCount zu demselben 1 Millisekundenfenster aus der vorherigen Einschleusung geführt hat, wird ERROR_NOT_READY zurückgegeben, und die Einschleusung wird nicht durchgeführt. Während die Einschleusung nicht sofort durch den Fehler ungültig wird, muss die nächste erfolgreiche Einschleusung einen PerformanceCount-Wert aufweisen, der mindestens 0,1 Millisekunden von der zuvor erfolgreichen Injektion entspricht. Dies gilt auch, wenn dwTime verwendet wird.
Wenn sowohl dwTime als auch PerformanceCount in InjectTouchInput angegeben werden, wird ERROR_INVALID_PARAMETER zurückgegeben.
InjectTouchInput kann nicht zwischen dwTime und PerformanceCount wechseln, nachdem die Einschleusung gestartet wurde.
Wenn weder dwTime noch PerformanceCount angegeben sind, weist InjectTouchInput den Zeitstempel basierend auf dem Zeitpunkt des Aufrufs zu. Wenn InjectTouchInput-Aufrufe wiederholt kleiner als 0,1 Millisekunden sind, werden möglicherweise ERROR_NOT_READY zurückgegeben. Durch den Fehler wird die Eingabe nicht sofort ungültig, aber die Einschleusanwendung muss denselben Frame erneut wiederholen, damit die Einschleusung erfolgreich ist.
historyCount
Typ: UINT32
Anzahl der Eingaben, die in dieser Nachricht zusammengefasst wurden. Diese Anzahl entspricht der Gesamtzahl der Einträge, die von einem Aufruf von GetPointerInfoHistory zurückgegeben werden können. Wenn keine Koalescierung aufgetreten ist, ist diese Anzahl 1 für die einzelne Eingabe, die durch die Nachricht dargestellt wird.
InputData
dwKeyStates
Art: DWORD
Gibt an, welche Tastaturmodifizierertasten zum Zeitpunkt der Eingabegenerierung gedrückt wurden. Kann null oder eine Kombination der folgenden Werte aus Modifiziererschlüsselzustand sein.
POINTER_MOD_SHIFT – Eine UMSCHALTTASTE wurde gedrückt.
POINTER_MOD_CTRL – Eine STRG-TASTE wurde gedrückt.
Verwenden Sie GetKeyState.
PerformanceCount
Typ: UINT64
Der Wert des hochauflösenden Leistungsindikators beim Empfang der Zeigernachricht (hochgenaue 64-Bit-Alternative zu dwTime). Der Wert kann kalibriert werden, wenn die Hardware des Touch-Digitizers die Scanzeitstempelinformationen im Eingabebericht unterstützt.
ButtonChangeType
Typ: POINTER_BUTTON_CHANGE_TYPE
Ein Wert aus der POINTER_BUTTON_CHANGE_TYPE-Enumeration , der die Änderung des Schaltflächenzustands zwischen dieser Eingabe und der vorherigen Eingabe angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | winuser.h (einschließlich Windows.h) |