Indicating Status (NDIS 5.1)
Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.
To indicate a change in the status of a NIC that it manages, a connectionless miniport driver calls NdisMIndicateStatus. A connection-oriented miniport driver calls NdisMCoIndicateStatus to indicate such a change.
NdisMCoIndicateStatus forwards the call to the bound protocol drivers, which interpret the general status code. Then the protocol drivers, NDIS Library, WMI, or other operating system entities can log the status change, take corrective action, or both.
A connectionless miniport driver must indicate when it is done transmitting status changes. Following one or more NdisMIndicateStatuscalls, a connectionless miniport driver calls NdisMIndicateStatusComplete. NDIS forwards the completion call to the protocol drivers so they can perform any necessary postprocessing. A connection-oriented miniport driver does not indicate when it is done transmitting status changes.
A miniport driver is not allowed to indicate status in the context of its MiniportInitialize, MiniportISR, MiniportHalt, or MiniportShutdown functions.
For a detailed description of indicating status, see Reporting Hardware Status.