SVR5 and SCO OpenServer 5

RequestIO(D3pccard)

RequestIO -- bind I/O addresses to a client

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RequestIO, ClientHandle_t *pClientHandle,
                     int n1, int RelReqIOLen,
                     RelReqIO_t *pRelReqIO, rm_key_t key);

Description

RequestIO( ) requests CardServices to access its resource configuration table and bind I/O addresses to a client.

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure that was returned from a previous call to the RegisterClient(D3pccard) service.
n1: NULL
RelReqIOLen: Length of the RelReqIO(D4pccard) structure. Must be set to 11.
pRelReqIO: Pointer to a RelReqIO(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LEN: RelReqIOLen not equal to 11.
BAD_ATTRIBUTE: Share and/or alias bit in the usAttributes1/2 member of the RelReqIO structure is invalid
BAD_BASE: Base port address not valid.
BAD_HANDLE: *pClientHandle does not point to registered owner.
BAD_SOCKET: Socket not valid.
CONFIGURATION_LOCKED: Earlier configuration still effective.
IN_USE: Some or all of I/O range requested is already in use.
NO_CARD: No card inserted.
SUCCESS: I/O address(es) bound to client.

Usage

RequestIO( ) is called as part of client configuration to request I/O address space for the card. The RequestIO service cannot override an active configuration. The ReleaseConfiguration(D3pccard) service must be invoked before using the RequestIO service. After the client secures I/O and other resources, it must issue a RequestConfiguration(D3pccard) request to begin using the resources it requested.

The RequestIO service is for 16-bit cards only. The 32-bit CardBus cards must use the RequestWindow(D3pccard) service to secure an I/O range. 16-bit cards must also use RequestWindow instead of RequestIO if the requested I/O address range is outside of the first 64 Kb of system I/O address space.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

16-bit PC Card only.

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), RelReqIO(D4pccard)

config(D2pccard), init(D2pccard), _load(D2pccard)