SVR5 and SCO OpenServer 5

RequestIRQ(D3pccard)

RequestIRQ -- bind an IRQ to a client

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RequestIRQ, ClientHandle_t *pClientHandle,
                     ISRAddress_t ISRAddress, int RelReqIRQLen,
                     RelReqIRQ_t *pRelReqIRQ, rm_key_t key);

Description

RequestIRQ( ) requests CardServices to access its resource configuration table and bind an IRQ to a Client.

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
ISRAddress
RelReqIRQLen: Length of the RelReqIRQ(D4pccard) structure. Must be set to 8 or 12.
pRelReqIRQ: Pointer to a RelReqIRQ(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LEN: RelReqIOLen not equal to 8 or 12.
BAD_ARGS: The ucIRQInfo1 and/or usIRQInfo2 member of the RelReqIRQ structure is not valid.
BAD_ATTRIBUTE: Share and/or pulse bit in the usAttributes member of the RelReqIO structure is invalid
BAD_HANDLE: *pClientHandle does not point to registered owner.
IRQ: IRQ not valid.
BAD_SOCKET: Socket not valid.
CONFIGURATION_LOCKED: Earlier configuration still effective.
IN_USE: IRQ requested is already in use.
NO_CARD: No card inserted.
SUCCESS: IRQ bound to client.

Usage

RequestIRQ( ) is called as part of client configuration. CardServices works with Socket Services to check that the PCIC chip can steer the requested interrupt to a free system interrupt request line. However, the RequestIRQ service can not override an active configuration. The ReleaseConfiguration(D3pccard) service must be invoked before using the RequestIRQ service. After the Client secures an IRQ and other resources, it must issue a RequestConfiguration(D3pccard) request to begin using the resources it had requested.

Context and synchronization

Interrupt, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), RelReqIRQ(D4pccard)

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