Share via

FilterStatus (Compact 7)

  • Article

3/12/2014

This function indicates status changes that are reported by NDIS or an underlying driver.

Syntax

VOID
  FilterStatus(
    IN NDIS_HANDLE  FilterModuleContext,
    IN PNDIS_STATUS_INDICATION  StatusIndication
    );

Parameters

  • FilterModuleContext
    A handle to the context area for the filter module. The filter driver created and initialized this context area in the FilterAttach function.

Return Value

None

Remarks

FilterStatus is an optional function. If a filter driver does not use status indications, it can set the entry point for this function to NULL when it calls the NdisFRegisterFilterDriver function.

To determine link status, use the status indications from underlying drivers instead of OID queries. These status indications will improve system performance and avoid possible race conditions.

A filter driver usually calls the NdisFIndicateStatus function at the end of its FilterStatus function to pass on the status indication to overlying drivers.

A filter driver can filter out certain status indications or modify the indicated status. To filter out a status indication, the driver merely does not call NdisFIndicateStatus.

NDIS calls FilterStatus at IRQL <= DISPATCH_LEVEL.

Requirements

Header

filter.h

See Also

Reference

NDIS Status Indication Functions for Filter Drivers
FilterAttach
NDIS_STATUS_INDICATION
NdisFIndicateStatus
NdisFRegisterFilterDriver