SVR5 and SCO OpenServer 5

ModifyConfiguration(D3pccard)

ModifyConfiguration -- partially modify socket and PC Card configuration

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (ModifyConfiguration, ClientHandle_t *ch,
                     int n2, int ModifyConfigurationLen,
                     ModifyConfiguration_t *mcfg, rm_key_t key);

Description

ModifyConfiguration( ) can partially modify a socket and PC Card configuration without having to resort to a pair of Release/RequestConfiguration services.

Arguments

ch: Pointer to a ClientHandle(D4pccard) structure.
n2: NULL
ModifyConfigurationLen: Length of the ModifyConfiguration(D4pccard) structure. Must be set to 7.
mcfg: Pointer to a ModifyConfiguration(D4pccard) structure.
key: Resource manager key.

Return values

NO_CARD: No card in socket.
BAD_ARG_LEN: ModifyConfigurationLen not equal to 7.
BAD_ATTRIBUTE: Can not enable/disable IRQ steering.
BAD_HANDLE: *ch does not point to the right Client.
BAD_SOCKET: Socket or function invalid.
BAD_VPP: Socket cannot deliver requested VPP1 or VPP2.
SUCCESS: Configuration successfully modified. Successfully added the socket service handler

Usage

The ClientHandle(D4pccard) structure that had earlier been passed to the RequestConfiguration(D3pccard) service is now passed again by the pointer *ch. Because it is necessary to pass a ClientHandle that had been passed to RequestConfiguration( ), ModifyConfiguration can deal only with a configuration originally set up by the RequestConfiguration( ) service.

The ModifyConfiguration service is useful for changing VPP1 or VPP2 without throwing away the present configuration. However, ModifyConfiguration has notable limitations. It can not change I/O address mapping, IRQ routing nor VCC. To change these, the configuration must be released and a new configuration with the new I/O, IRQ, and/or VCC requested.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), ModifyConfiguration(D4pccard)