IMiniportWaveCyclicStream::SetNotificationFreq

The SetNotificationFreq method controls the frequency at which notification interrupts are generated by setting the interval between successive interrupts.

ULONG
  SetNotificationFreq(
    IN ULONG  Interval,
    OUT PULONG  FrameSize
    );

Parameters

Interval

Specifies the interval between notification interrupts. This parameter value is expressed in milliseconds.

FrameSize

Output pointer for the frame size. This parameter points to a caller-allocated variable into which the method writes the maximum number of bytes that can be transferred in Interval milliseconds. This byte count determines the size of the buffer that needs to be allocated for the input or output stream.

Return Value

SetNotificationFreq returns the new notification interval expressed in milliseconds. In all current Windows releases, the port driver ignores this value.

Headers

Declared in portcls.h. Include portcls.h.

Comments

During each notification interrupt, the miniport driver's interrupt service routine calls the IPortWaveCyclic::Notify method with the stream's IServiceGroup object as the call parameter. This is the IServiceGroup object that the miniport driver previously output to the port driver during the IMiniportWaveCyclic::NewStream call.

In all current Windows releases, the WaveCyclic port driver specifies an Interval value of 10 milliseconds. This value might change in future releases.

The SetNotificationFreq method is called at IRQL PASSIVE_LEVEL.

See Also

IPortWaveCyclic::Notify, IServiceGroup, IMiniportWaveCyclic::NewStream