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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005