NdisMIndicateStatusComplete function

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.

NdisMIndicateStatusComplete notifies NDIS (or NDISWAN) that the NIC driver, which has called NdisMIndicateStatus one or more times to indicate hardware anomalies or run-time state changes in the NIC, is ready to resume normal device I/O operations.

Syntax

VOID NdisMIndicateStatusComplete(
  _In_ NDIS_HANDLE MiniportAdapterHandle
);

Parameters

Return value

None

Remarks

When a miniport driver calls NdisMIndicateStatusComplete, NDIS calls the ProtocolStatusComplete function(s) of bound protocol(s) that were previously notified of the immediately preceding state change(s) in the underlying NIC with calls to their ProtocolStatus functions.

A miniport driver eventually must call NdisMIndicateStatusComplete after it calls NdisMIndicateStatus. However, a miniport driver need not deliver NdisMIndicateStatusComplete indications in one-to-one correspondence with its NdisMIndicateStatus indications. It can choose to issue a single status-complete indication for several status indications that have occurred, particularly when network traffic is high.

A protocol driver writer should assume that interrupts are enabled on the NIC while the ProtocolStatusComplete function is running. A protocol driver writer also should assume that the ProtocolStatus function is reentrant while the ProtocolStatusComplete function is running, particularly on an SMP platform.

A miniport driver must release any spin lock that it is holding before calling NdisMIndicateStatusComplete.

Serialized callers of NdisMIndicateStatusComplete must run at IRQL = DISPATCH_LEVEL. Deserialized callers of NdisMIndicateStatusComplete must run at IRQL <= DISPATCH_LEVEL.

Requirements

Target platform

Universal

Version

Not supported for NDIS 6.0 drivers in Windows Vista. Use NdisMIndicateStatusExinstead. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

See Remarks section

See also

MiniportInitialize

NdisMIndicateStatus

ProtocolStatusComplete

 

 

Send comments about this topic to Microsoft