# Window.PollPointerEvent

Last updated: 2026-09-09

Pump native messages and latch the next ordered pointer event for a window.

Built into Yeho; no import is needed. These additions have Windows CPU-oracle developer-host evidence. Kyber rejects these operations; this does not qualify Starfish or other targets.

`Window.PollPointerEvent(int handle) -> bool`

Windows CPU-oracle only. Another poll replaces the snapshot; an empty poll clears it. The 128-record queue coalesces adjacent compatible motion. Overflow cancels the gesture and signals discontinuity. Other hosts throw window.pointer.unsupported. Handle 0 only illustrates the type-checked call shape.

Contract and host execution evidence: yeho/docs/runtime/hardware-host-tools.md. This small example was type checked, not executed.

## Parameters

- handle (int): A live Window handle. Invalid handles return false.

## Type-checked example

```yeho
int handle = 0
bool available = Window.PollPointerEvent(handle)
```

project.mech:

```toml
manifestVersion = "2"
package = "api.example.runtime__window_pollpointerevent"
version = "0.1.0"
languageEdition = "yeho-core-2026.1"

[app]
kind = "headless"
```

Source: yeho/src/compiler/common/intrinsic_registry.cpp:1109