SVR5 and SCO OpenServer 5

RequestConfiguration(D3pccard)

RequestConfiguration -- physically configure client's card and socket

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RequestConfiguration, ClientHandle_t *pClientHandle,
                     int n1, int RequestConfigurationLen,
                     RequestConfiguration_t *req, rm_key_t key);

Description

RequestConfiguration( ) requests CardServices to physically configure the Client's card and its socket. CardServices then turns on power to the socket and binds the socket to any DMA channel, memory and I/O windows, and IRQ that the Client had previously requested.

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
n1: NULL
RequestConfigurationLen: Length of the RequestConfiguration(D4pccard) structure. Must be set to 17 or 18.
req: Pointer to a RequestConfiguration(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LENGTH: RequestConfigurationLen not equal to 17 or 18.
BAD_ATTRIBUTE: IRQ steering enable conflict.
BAD_HANDLE: *pClientHandle invalid.
BAD_TYPE: Memory and I/O not supported.
BAD_SOCKET: Invalid socket
BAD_VCC: Can not turn on specified voltage.
BAD_VPP: Can not turn on specified voltage.
CONFIGURATION_LOCKD: Old configuration still effective.
NO_CARD: No card in socket.
IN_USE: Another client is using the card.
SUCCESS: Card and socket successfully configured.

Usage

RequestConfiguration( ) is called as part of client configuration to configure the card and socket according to the system resources that were requested by the RequestDMA(D3pccard), RequestIO(D3pccard), and RequestIRQ(D3pccard) services. The system resources must have been requested first or there will be nothing to which to bind the socket and configuration will fail.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

RequestIO(D3pccard), RequestConfiguration(D4pccard), RequestIRQ(D3pccard), RequestDMA(D3pccard), RequestWindow(D3pccard)