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