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