Rockwell Automation 1747-PCIS API Software - Open Controller - Manual (Page 66)

Publication 1747-UM002A-US-P - June 2000
6-6 Library of Routines
OC_CreateIO
Configuration OC_CreateIOConfiguration creates a scanner configuration from an
application-specific installation of rack sizes and installed modules.
See chapter 5 for more information.
Syntax:
int OC_CreateIOConfiguration(OCIOCFG *iocfg);
Parameters:
Description:
Modules can be specified by name or by mix and type. The function
automatically fills in the rest of the required information in the
OCIOCFG structure.
This function returns in iocfg the scanner configuration information
obtained from the rack sizes and installed module types specified in
iocfg . The scanner configuration can then be downloaded to the
scanner with OC_DownloadIOConfiguration, which allows the
application to control the number of racks and their sizes and the
position and type of modules installed in the racks.
The OCIOCFG structure is defined as:
typedef struct tagOCIOCFG
{
BYTE Rack1Size;/* number of slots in Rack 1 */
BYTE Rack2Size;/* number of slots in Rack 2 */
BYTE Rack3Size;/* number of slots in Rack 3 */
OCSLOTCFG SlotCfg[OCMAXSLOT];/* configuration for each
slot */
} OCIOCFG;
Return Value:
Considerations:
Supported in the DOS API library and the Windows NT API library
Parameter: Description:
iocfg Specifies the rack sizes and installed modules
Name: Value: Description:
SUCCESS 0 I/O configuration was read successfully
ERR_OCUNKNOWN 18 at least one module was not found in the internal database
The
SlotCfg data for the unknown module is not altered; the
remaining modules are configured.