PtQuerySystemInfo()

Query the system for information

Synopsis:

PhSysInfo_t * PtQuerySystemInfo( 
                  PtWidget_t *widget,
                  PhSysInfo_t *sys_ptr );

Library:

ph

Description:

This function queries the system for information on the given widget:

The information is stored in the PhSysInfo_t structure pointed to by sys_ptr.

This function calls PhQuerySystemInfo(), but buffers the information, reducing the number of messages sent to the Photon server. It calls PhQuerySystemInfo() if the data has been made invalid since the previous call because:

The rectangular area passed to PhQuerySystemInfo() is the extent of the window containing the widget (or the widget itself if it's a window).

Returns:

A pointer to the PhSysInfo_t structure passed to the function, or NULL if an error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhQuerySystemInfo(), PhSysInfo_t

System information in the Regions chapter of the Photon Programmer's Guide.