Gets or sets the current report interval for the gyrometer.
public:
property uint32 ReportInterval {
uint32 get ();
void set (uint32 value);
}
Type: uint32
The report interval is specified in milliseconds.
An application must set the report interval to a non-zero value prior to registering an event handler or calling GetCurrentReading. This informs the sensor implementation that it should allocate resources to satisfy the application’s requirements.
Conversely, when an application is finished with the sensor, it should explicitly return the sensor to its default report interval by setting it to zero. This is important for power conservation, especially when using a language that may keep the sensor object active for an indefinite period prior to garbage collection.
The application should consult the MinimumReportInterval property prior to setting the report interval to ensure that the sensor can honor the requested report interval. Setting a value below the minimum supported interval will either trigger an exception or have undefined results.
Although the application can set this value to request a particular report interval, the driver will determine the actual report interval, based on internal logic. For example, the driver might use the shortest report interval that is requested by any caller.
Setting a value of zero requests the driver to use its default report interval. As with requesting a specific interval, the driver may choose a different interval based on other client requests and internal logic.
The Sensor platform automatically sets the change sensitivity for gyrometers based on the current report interval. This table specifies the change sensitivity values for given intervals.
| Current report interval (specified in milliseconds) | Change sensitivity (specified as degrees per second) |
|---|---|
| 1 ms – 16 ms | 0.1 DPS |
| 17 ms – 32 ms | 0.5 DPS |
| >= 33 ms | 1.0 DPS |
Namespace: Windows.Devices.Sensors
Metadata: windows.winmd