SVR5 and SCO OpenServer 5
ReleaseIRQ(D3pccard)
ReleaseIRQ --
unbind IRQs that are bound to a client
Synopsis
#include <sys/types.h>
#include <sys/lcs.h>
#include <sys/lss.h>
int CardServices (ReleaseIRQ, ClientHandle_t *pClientHandle,
int n1, int RelReqIRQLen,
RelReqIRQ_t *pRelReqIRQ, rm_key_t key);
Description
ReleaseIRQ( )
requests
CardServices( )
to access its resource configuration table
and unbind IRQs
that a client had previously requested bound to itself
with the
RequestIRQ(D3pccard)
service.
Arguments
pClientHandle-
Pointer to a
ClientHandle(D4pccard)
structure.
n1-
NULL
RelReqIRQLen-
Length of the
RelReqIRQ(D4pccard)
structure.
Must be set to 5.
pRelReqIRQ-
Pointer to a
RelReqIRQ(D4pccard)
structure.
key-
Resource manager
key.
Return values
BAD_ARG_LENGTH-
RelReqIRQLen not equal to 5.
BAD_ATTRIBUTE-
Attributes do not match those listed
in the configuration table.
BAD_IRQ-
IRQ to be released does not match
the IRQ listed in the corresponding part
of the configuration table.
BAD_HANDLE-
*pClientHandle does not point to the registered owner
or there is no IRQ to unbind.
BAD_SOCKET-
Socket not valid.
CONFIGURATION_LOCKED-
Old configuration still effective.
SUCCESS-
IRQ unbound from client.
Usage
ReleaseIRQ( )
is called as part of client removal
to release IRQs that were requested by the
RequestIRQ(D3pccard)
service.
The system interrupt request line is returned
to the pool of free system resources.
However, the ReleaseIRQ service
can not override an active configuration.
The
ReleaseConfiguration(D3pccard)
service must be invoked before using the
ReleaseIRQ(D3pccard)
service.
DDI drivers must also call
cm_intr_detach(D3)
to detach the interrupts for the device
whenever they call
ReleaseIRQ( ).
Context and synchronization
Interrupt, initialization, or user
context
Hardware applicability
All
Version applicability
pccard:
1, 2, 3
References
ClientHandle(D4pccard),
RelReqIRQ(D4pccard),
RequestIRQ(D3pccard)
config(D2pccard),
halt(D2pccard),
_unload(D2pccard)
cm_intr_detach(D3)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005