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:

• system bandwidth
• graphics drivers and their capabilities
• pointing devices
• keyboard devices.

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 window containing the widget was moved or resized
• you switched consoles
• a graphics or input driver was started or stopped
• someone started or stopped dittoing you
• ...

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

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.