NdisMIndicateStatus (Compact 2013)

3/26/2014

This function indicates changes in the status of a network adapter to higher-level NDIS drivers.

Syntax

VOID NdisMIndicateStatus(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS GeneralStatus,
  PVOID StatusBuffer,
  UINT StatusBufferSize
);

Parameters

• MiniportAdapterHandle
  [in] Handle originally input to the MiniportInitialize function

• GeneralStatus
  [in] Specifies the NDIS_STATUS_XXX value that indicates the general change in status for the network adapter

• StatusBuffer
  [in] Pointer to a caller-allocated buffer that contains data that is medium-specific and dependent on the value of GeneralStatus. It indicates detailed information about the change in status.

• StatusBufferSize
  [in] Specifies the size, in bytes, of the buffer at StatusBuffer

Return Value

None

Remarks

When a miniport calls NdisMIndicateStatus, NDIS calls each bound protocol's ProtocolStatus function. This allows for a bound protocol driver or, possibly, the configuration manager to log the change in status of an underlying network adapter or to take corrective action. For example, a protocol might call the NdisReset function, depending on the NDIS_STATUS_XXX indicated.

When a miniport calls NdisMIndicateStatus to report a change in status, NDIS can call the MiniportReset function to try to restore the network adapter to a working condition. In these circumstances, NDIS can call bound protocols only with NDIS_STATUS_RESET_START and later with NDIS_STATUS_RESET_END, instead of with the GeneralStatus indicated by the miniport.

NdisMIndicateStatus provides two pieces of information:

• An overall status value that indicates the general change in status
• A specific reason for the general change, which can be network-specific

A miniport can also call NdisMIndicateStatus to indicate problems such as cables that have been accidentally removed and then reinserted, or a ring that has temporarily failed.

Requirements

See Also

Reference

NDIS 5.x Legacy Functions
MiniportInitialize
MiniportReset
NdisMIndicateStatusComplete
NDIS_MAC_FRAGMENT
NDIS_MAC_LINE_UP
NDIS_MAC_LINE_DOWN
NDIS_TAPI_EVENT
NdisReset
ProtocolStatus