GetPointerInfo-Funktion (winuser.h)
Ruft die Informationen für den angegebenen Zeiger ab, der der aktuellen Nachricht zugeordnet ist.
Syntax
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
Parameter
[in] pointerId
Der Zeigerbezeichner.
[out] pointerInfo
Adresse einer POINTER_INFO Struktur, die die Zeigerinformationen empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich 0.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
GetPointerInfo ruft Informationen für einen einzelnen Zeiger ab, der einer Zeigernachricht zugeordnet ist.
Verwenden Sie GetPointerFrameInfo , um Frameinformationen abzurufen, die einer Nachricht für eine Reihe von Zeigern zugeordnet sind.
Die von GetPointerInfo zurückgegebenen Informationen sind der neuesten Zeigernachricht zugeordnet, die vom aufrufenden Thread abgerufen wurde. Wenn die nächste Nachricht vom aufrufenden Thread abgerufen wird, sind die informationen, die der vorherigen Nachricht zugeordnet sind, möglicherweise nicht mehr verfügbar.
Wenn die Anwendung Zeigereingabenachrichten nicht so schnell verarbeitet, wie sie generiert werden, werden einige Nachrichten möglicherweise zu einer WM_POINTERUPDATE Nachricht zusammengefasst. Verwenden Sie GetPointerInfoHistory , um den Nachrichtenverlauf aus der neuesten WM_POINTERUPDATE-Nachricht abzurufen.
Wenn die der Nachricht zugeordneten Informationen nicht mehr verfügbar sind, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_NO_DATA festgelegt ist.
Wenn der aufrufende Thread nicht im Besitz des Fensters ist, in das die Zeigernachricht gesendet wurde, schlägt diese Funktion fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist. Beachten Sie, dass dies das Fenster sein kann, an das die Eingabe ursprünglich übermittelt wurde, oder ein Fenster, an das die Nachricht weitergeleitet wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393) |