ProtocolStatusEx (Compact 2013)

3/26/2014

This function indicates status-changes from underlying connectionless drivers or NDIS.

Syntax

VOID
  ProtocolStatusEx(
    IN NDIS_HANDLE  ProtocolBindingContext,
    IN PNDIS_STATUS_INDICATION  StatusIndication
    );

Parameters

• ProtocolBindingContext
  A handle to a context area that the protocol driver allocated. The protocol driver maintains the per-binding context information in this context area. The driver supplied this handle to NDIS when the driver called the NdisOpenAdapterEx function.

• StatusIndication
  A pointer to an NDIS_STATUS_INDICATION structure that contains the status information.

Return Value

None

Remarks

A call to ProtocolStatusEx notifies the protocol driver about changes in status of an underlying driver.

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.

NDIS calls the ProtocolStatusEx function of all bound protocol drivers when an underlying driver is resetting a network adapter. First NDIS specifies the NDIS_STATUS_RESET_START code and then later, when the reset operation is complete, NDIS specifies the NDIS_STATUS_RESET_END code.

NDIS will not accept send requests and OID requests for a miniport adapter while a reset operation is in progress, the NDIS_STATUS_RESET_START notification warns bound protocol drivers to stop such requests on the affected binding until they receive the corresponding NDIS_STATUS_RESET_END notification.

NDIS calls ProtocolStatusEx at IRQL <= DISPATCH_LEVEL.

See Also

Reference

NDIS Status Indication Functions for Protocol Drivers
MiniportResetEx
NDIS_STATUS_INDICATION
NDIS_STATUS_RESET_END
NDIS_STATUS_RESET_START
NdisOpenAdapterEx