Rockwell Automation 1747-PCINT API Software for 1746 I/O - Manual (Page 61)

OC_CreateIO Configuration Library of Routines 6–7
Publication 1747-6.5.3 June 1998
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.