[Previous] [Contents] [Index] [Next]

PtQuerySystemInfo()

Query the system for information

Synopsis:

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

Description:

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

The information is stored in the buffer 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()

For a description of PhSysInfo_t and the information it provides, see PhT.h and "System information" in the Regions chapter of the Programmer's Guide.


[Previous] [Contents] [Index] [Next]