MgslSetPortConfigEx

Prototype
`ULONG MgslSetPortConfigEx( ULONG PortID, PMGSL_PORT_CONFIG_EX pConfig );`
Parameters
`PortID`	Integer port identifier
`pConfig`	pointer to MGSL_PORT_CONFIG_EX structure which describes a SyncLink adapter hardware settings
Return Value
`ERROR_SUCCESS (0)`	Parameter set successful
`ERROR_INVALID_PARAMETER`	error in MGSL_PORT_CONFIG_EX structure.
`ERROR_ACCESS_DENIED`	use has insufficient privilege

Configures a SyncLink adapter port hardware settings. The hardware settings are specified with the MGSL_PORT_CONFIG_EX structure. The settings are stored in the registry, with the location dependent on the platform. Calling this function requires the user to have administrative privilege.

Calling MgslSetPortConfigEx with a MGSL_PORT_CONFIG_EX structure alters an existing port configuration or adds a new port configuration. Setting pConfig to NULL deletes an existing port configuration. When starting, the device driver attempts to initialize all configured ports. If a port fails to initialize then an error is reported. If an adapter is removed from the system, then the port configuration should also be removed to prevent errors from being reported.

Contents