Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 11 - Program-to-Program Communications Toolbox / PPC Toolbox Reference

Application-Defined Routines / Port Filter Functions

MyPortFilter

You can provide a pointer to a port filter function in the portFilter parameter of the PPCBrowser function.You can use a port filter function to refine the list of PPC ports that the PPCBrowser function displays in the program linking dialog box.

FUNCTION MyPortFilter (locationName: LocationNamePtr; 
                       thePortInfo: PortInfoPtr): Boolean; 

locationName

A pointer to a location name record. This record specifies the location of the PPC port currently under consideration for display in the program linking dialog box.

thePortInfo

A pointer to a port information record. This record specifies the port information for the PPC port currently under consideration for display in the program linking dialog box.

DESCRIPTION

The PPCBrowser function calls your port filter function once for each port before it adds that port to the dialog list. Your port filter function should return TRUE for each port that should be displayed in the program linking dialog box, and FALSE for each port that shouldn't be displayed.

SEE ALSO

For an example of a port filter function, see Listing 11-3 on page 11-24. For a description of the location name record, see page 11-50. For a description of the port information record, see page 11-51.