Middleware, development tools, realtime operating system
software and services for superior embedded design
- Developer Resources
- Blogs
- Board support packages
- Foundry27 projects
- Forums
- Hardware support listing
- Online video tutorials
- Product documentation
- Technical Articles
![[Previous]](../prev.gif) |
![[Contents]](../contents.gif) |
![[Index]](../keyword_index.gif) |
![[Next]](../next.gif) |
PtFindSurface()
Find the control surface with a given ID
Synopsis:
PtSurface_t *PtFindSurface( PtWidget_t *widget,
uchar_t surface_id );
Library:
ph
Description:
This function locates a control surface belonging to a given widget, using the surface's numerical ID, surface_id, as a search key.
Returns:
A pointer to the structure representing the control surface, or NULL if the specified surface couldn't be found.
 |
Since control surfaces are maintained internally as an array, it's not uncommon for them to shift around in memory as surfaces are added and removed, thereby possibly invalidating a pointer returned by this function. As such, all surface pointers should be regarded as transient, and you should retrieve an updated copy whenever there's a chance that the widget's surface configuration might have changed. |
Classification:
Photon
| Safety: | |
|---|---|
| Interrupt handler | No |
| Signal handler | No |
| Thread | No |
See also:
PtFindSurfaceByAction(), PtWidgetActiveSurface()
Control Surfaces chapter of the Photon Programmer's Guide
|
|
|
|
All content ©2004-2008, QNX Software Systems