#include <IOKit/IOFilterInterruptEventSource.h>
IOKit/IOFilterInterruptEventSource.h
classIOFilterInterruptEventSource
@class IOFilterInterruptEventSource : public IOInterruptEventSource
@abstract Filtering varient of the $link IOInterruptEventSource.
@discussion 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.
<br><br>
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.
<br><br>
If you are implementing 'SoftDMA' (or pseudo-DMA), you may not want the I/O Kit to automatically start your interrupt handler routine on your work loop when your filter routine returns true. In this case, you may choose to have your filter routine schedule the work on the work loop itself and then return false. If you do this, the interrupt will not be disabled in hardware and you could receive additional primary interrupts before your work loop–level service routine completes. Because this scheme has implications for synchronization between your filter routine and your interrupt service routine, you should avoid doing this unless your driver requires SoftDMA.
<br><br>
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.
: public IOInterruptEventSource
| Filter | filterAction | |
| ExpansionData * | reserved |
static OSPtr<IOFilterInterruptEventSource> filterInterruptEventSource( OSObject *owner, IOInterruptEventSource::Action action, Filter filter, IOService *provider, int intIndex = 0 )static
@function filterInterruptEventSource
@abstract Factor method to create and initialise an IOFilterInterruptEventSource. See $link init.
@param owner Owner/client of this event source.
@param action 'C' Function to call when something happens.
@param filter 'C' Function to call when interrupt occurs.
@param provider Service that provides interrupts.
@param intIndex Defaults to 0.
@result a new event source if succesful, 0 otherwise.
static OSPtr<IOFilterInterruptEventSource> filterInterruptEventSource( OSObject *owner, IOService *provider, int intIndex, IOInterruptEventSource::ActionBlock action, FilterBlock filter )static
@function filterInterruptEventSource
@abstract Factor method to create and initialise an IOFilterInterruptEventSource. See $link init.
@param owner Owner/client of this event source.
@param provider Service that provides interrupts.
@param intIndex The index of the interrupt within the provider's interrupt sources.
@param action Block for the callout routine of this event source.
@param filter Block to invoke when HW interrupt occurs.
@result a new event source if succesful, 0 otherwise.
virtual bool init( OSObject *owner, IOInterruptEventSource::Action action, Filter filter, IOService *provider, int intIndex = 0 )virtual
@function init
@abstract Primary initialiser for the IOFilterInterruptEventSource class.
@param owner Owner/client of this event source.
@param action 'C' Function to call when something happens.
@param filter 'C' Function to call in primary interrupt context.
@param provider Service that provides interrupts.
@param intIndex Interrupt source within provider. Defaults to 0.
@result true if the inherited classes and this instance initialise
successfully.
APPLE_KEXT_OVERRIDE
virtual void free(void)virtualvirtual void signalInterrupt()virtual
@function signalInterrupt
@abstract Cause the work loop to schedule the action.
@discussion 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 $link IOFilterInterruptSource::Filter
virtual Filter getFilterAction() constvirtual
@function getFilterAction
@abstract Get'ter for filterAction variable.
@result value of filterAction.
FilterBlock getFilterActionBlock() const
@function getFilterActionBlock
@abstract Get'ter for filterAction variable.
@result value of filterAction.
APPLE_KEXT_OVERRIDE virtual void normalInterruptOccurred(void *self, IOService *prov, int ind)virtual
@function normalInterruptOccurred
@abstract Override $link IOInterruptEventSource::normalInterruptOccured to make a filter callout.
APPLE_KEXT_OVERRIDE virtual void disableInterruptOccurred(void *self, IOService *prov, int ind)virtual
@function disableInterruptOccurred
@abstract Override $link IOInterruptEventSource::disableInterruptOccurred to make a filter callout.
macroIOFilterInterruptAction
@defined IOFilterInterruptAction
@discussion Backward compatibilty define for the old non-class scoped type definition. See $link IOFilterInterruptSource::Filter
#define IOFilterInterruptAction IOFilterInterruptEventSource::Filter