Indicating CoNDIS WAN Miniport Driver 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.
A CoNDIS WAN miniport driver calls NdisMCoIndicateStatusto indicate status changes up to bound protocol drivers. For more information about indicating status from a CoNDIS miniport driver or MCM, see Indicating Miniport Driver Status.
Bound protocol drivers can ignore these status indications. However, processing these indications typically results in improved performance for protocol drivers and the miniport driver.
The NDISWAN intermediate driver forwards status indications to NDIS. NDIS calls the ProtocolCoStatusfunctions of bound protocols or a configuration manager. These protocols or configuration manager can log these indications and possibly take corrective action, if necessary.
For a CoNDIS WAN miniport driver, a call to NdisMCoIndicateStatusis the same as in any CoNDIS miniport driver, except that the CoNDIS WAN miniport driver indicates a WAN-specific status for each VC on the miniport driver's NIC. The miniport driver calls NdisMCoIndicateStatuswith an explicit VC handle to indicate these changes up to a protocol driver that shares this VC. If the driver specifies a NULLNdisVcHandle, the status pertains to a general change in the state of the NIC.
Each status indication provides two basic pieces of information:
A status code that specifies the general status. There are a limited number of defined general status codes; this list is subject to future expansion.
A buffer that contains the status information. This status information can be specific to a NIC, or, for a CoNDIS WAN miniport driver, specific to a VC on a NIC. For example, a buffer might contain the new transmit speed of an X.25 connection, which recently decreased by a factor of two.
The CoNDIS WAN VC status indications are:
NDIS_STATUS_WAN_CO_LINKPARAMS
A CoNDIS WAN miniport driver calls NdisMCoIndicateStatus to indicate that the parameters for a particular VC that is active on the NIC have changed. In this call, the miniport driver passes the handle to the VC in the NdisVcHandle parameter, NDIS_STATUS_WAN_CO_LINKPARAMS in the GeneralStatus parameter, and a pointer to a WAN_CO_LINKPARAMS structure in the StatusBuffer parameter. WAN_CO_LINKPARAMS describes new parameters for the VC.
NDIS_STATUS_WAN_CO_FRAGMENT
A CoNDIS WAN miniport driver calls NdisMCoIndicateStatus to indicate that it has received a partial packet from the endpoint of a VC. In this call, the miniport driver passes the handle to the VC in the NdisVcHandle parameter, NDIS_STATUS_WAN_CO_FRAGMENT in the GeneralStatus parameter, and a pointer to an NDIS_WAN_CO_FRAGMENT structure in the StatusBuffer parameter. NDIS_WAN_CO_FRAGMENT describes the reason that the partial packet was received.
After this indication occurs, a connection-oriented client should send frames to the connection-oriented client at the other end of the VC. These frames will notify the opposite endpoint of the partial-packet situation, so that the opposite endpoint is not required to wait for a time-out to occur.
NDISWAN monitors dropped packets by counting the number of fragment indications on each VC.