ADC Home > Reference Library > Reference > Darwin > Kernel Framework Reference
|
IOFilterInterruptEventSource |
Inherits from: | |
Declared In: |
Filtering varient of the IOInterruptEventSource.
An interrupt event source that calls the client to determine if a interrupt event needs to be scheduled on the work loop. A filter interrupt event source call's the client in the primary interrupt context, the client can then interrogate its hardware and determine if the interrupt needs to be processed yet.
As the routine is called in the primary interrupt context great care must be taken in the writing of this routine. In general none of the generic IOKit environment is safe to call in this context. We intend this routine to be used by hardware that can interrogate its registers without destroying state. Primarily this variant of event sources will be used by drivers that share interrupts. The filter routine will determine if the interrupt is a real interrupt or a ghost and thus optimise the work thread context switch away.
CAUTION: Called in primary interrupt context, if you need to disable interrupt to guard you registers against an unexpected call then it is better to use a straight IOInterruptEventSource and its secondary interrupt delivery mechanism.
Override IOInterruptEventSource::disableInterruptOccurred to make a filter callout.
Factor method to create and initialise an IOFilterInterruptEventSource. See init.
Get'ter for filterAction variable.
Primary initialiser for the IOFilterInterruptEventSource class.
Override IOInterruptEventSource::normalInterruptOccured to make a filter callout.
Cause the work loop to schedule the action.
disableInterruptOccurred |
Override IOInterruptEventSource::disableInterruptOccurred to make a filter callout.
public
virtual void disableInterruptOccurred( void *self, IOService *prov, int ind);
filterInterruptEventSource |
Factor method to create and initialise an IOFilterInterruptEventSource. See init.
public
static IOFilterInterruptEventSource * filterInterruptEventSource( OSObject *owner, IOInterruptEventSource::Action action, Filter filter, IOService *provider, int intIndex = 0);
owner
Owner/client of this event source.
action
'C' Function to call when something happens.
filter
'C' Function to call when interrupt occurs.
provider
Service that provides interrupts.
intIndex
Defaults to 0.
a new event source if succesful, 0 otherwise.
getFilterAction |
Get'ter for filterAction variable.
public
virtual Filter getFilterAction() const;
value of filterAction.
init |
Primary initialiser for the IOFilterInterruptEventSource class.
public
virtual bool init( OSObject *owner, IOInterruptEventSource::Action action, Filter filter, IOService *provider, int intIndex = 0);
owner
Owner/client of this event source.
action
'C' Function to call when something happens.
filter
'C' Function to call in primary interrupt context.
provider
Service that provides interrupts.
intIndex
Interrupt source within provider. Defaults to 0.
true if the inherited classes and this instance initialise successfully.
normalInterruptOccurred |
Override IOInterruptEventSource::normalInterruptOccured to make a filter callout.
public
virtual void normalInterruptOccurred( void *self, IOService *prov, int ind);
signalInterrupt |
Cause the work loop to schedule the action.
public
virtual void signalInterrupt();
Cause the work loop to schedule the interrupt action even if the filter routine returns 'false'. Note well the interrupting condition MUST be cleared from the hardware otherwise an infinite process interrupt loop will occur. Use this function when 'SoftDMA' is desired. See IOFilterInterruptSource::Filter
Filter |
public
typedef bool ( *Filter)( OSObject *, IOFilterInterruptEventSource *);
owner
Pointer to the owning/client instance.
sender
Where is the interrupt comming from.
false if this interrupt can be ignored.
C Function pointer to a routine to call when an interrupt occurs.
ExpansionData |
protected
struct ExpansionData { };
This structure will be used to expand the capablilties of the IOWorkLoop in the future.
filterAction |
Filter callout
protected
Filter filterAction;
reserved |
protected
ExpansionData *reserved;
Reserved for future use. (Internal use only)
IOFilterInterruptAction |
#define IOFilterInterruptAction IOFilterInterruptEventSource::Filter
Backward compatibilty define for the old non-class scoped type definition. See IOFilterInterruptSource::Filter
|
Last Updated: 2008-12-19