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)