Hardware Dev Center

IPortMidi::Notify method

The Notify method notifies the port driver that an interrupt indicating the progress of the DMA pointer has occurred. It should be called from the miniport driver's interrupt service routine (ISR).

Syntax


void Notify(
  [in, optional] PSERVICEGROUP ServiceGroup
);

Parameters

ServiceGroup [in, optional]

Pointer to the miniport driver's IServiceGroup object.

Return value

None

Remarks

This method is vital for accurate timing. Most miniports will call this method in response to a notification interrupt after having cleared the interrupt source. Although the miniport driver is free to use other methods for determining when to call this method, precise timing is important and should be maintained.

When an adapter driver installs an ISR, it submits a ServiceContext parameter along with the ISR's entry point (for details, see Providing ISR Context Information). When the interrupt occurs, the operating system calls the ISR and passes ServiceContext as a call parameter to the ISR. Although the meaning of the ServiceContext parameter is known only to the driver developer, it is typically a pointer to the miniport object. The ISR uses this pointer to access information about the miniport object.

The ServiceGroup parameter follows the reference-counting conventions for COM objects.

Requirements

Target platform

Universal

Header

Portcls.h (include Portcls.h)

IRQL

Any level

See also

IServiceGroup

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft