Instance Property

getElementValue

Obtains the most recent value of an element.

Declaration

IOReturn (*getElementValue)(void *self, IOHIDElementCookie elementCookie, IOHIDEventStruct *valueEvent);

Parameters

elementCookie

The element of interest.

valueEvent

The event that will be filled. If a long value is present, it is up to the caller to deallocate it.

Return Value

Returns an IOReturn code.

Discussion

This call is most useful for interrupt driven elements, such as input type elements. Since feature type element values need to be polled from the device, it is recommended to use the queryElementValue method to obtain the current value. The timestamp field in the event details the last time the element value was altered.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software