DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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