DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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