Share via

NDIS_MAC_FRAGMENT (Compact 2013)

  • Article

3/26/2014

This structure contains information associated with a fragment indication made by a WAN network adapter miniport.

Syntax

typedef struct _NDIS_MAC_FRAGMENT {
    NDIS_HANDLE NdisLinkContext;
    ULONG Errors;
} NDIS_MAC_FRAGMENT, *PNDIS_MAC_FRAGMENT;

Members

  • NdisLinkContext
    [in] Specifies the handle that identifies the link that the miniport set in the line-up indication when the link was established.

  • Errors
    [in] A 32-bit value that specifies a bitmask that is set with one or more of the following system-defined values to indicate why the fragment was received. The miniport driver can set a combination of the following values by using the binary OR operator:

    Error Flag

    Description

    WAN_ERROR_CRC

    Specifies a CRC error was encountered for a particular static virtual channel. CRC errors are caused by the failure of a cyclic redundancy check. A CRC error indicates that one or more bytes in a frame received were found garbled on arrival.

    WAN_ERROR_FRAMING

    Specifies a framing error was encountered for a particular static virtual channel. A framing error occurs when an asynchronous byte is received with an invalid start or stop bit.

    WAN_ERROR_HARDWAREOVERRUN

    Specifies a hardware overrun was encountered for a particular static virtual channel. Hardware overruns occur when the WAN network adapter cannot handle the rate at which data is received.

    WAN_ERROR_BUFFEROVERRUN

    Specifies a buffer overrun was encountered for a particular static virtual channel. Buffer overruns occur when the WAN miniport driver cannot handle the rate at which data is received.

    WAN_ERROR_TIMEOUT

    Specifies a time-out error was encountered for a particular static virtual channel. Time-out errors occur when an expected byte is not received in time.

    WAN_ERROR_ALIGNMENT

    Specifies an alignment error was encountered for a particular static virtual channel. Alignment errors occur when a byte received differs from the byte expected. This typically happens when a byte is lost or when a time-out error occurs.

    If no direct mapping from the WAN medium error to one of the previous error flags exists, select the most appropriate flag or combination of flags.

Remarks

A WAN network adapter driver calls NdisMIndicateStatus with this kind of indication when it receives a partial packet from a remote node on the wide area network.

The WAN protocol driver forwards such a fragment indication to the affected protocol(s), formatted as an NDIS_WAN_FRAGMENT structure.

Requirements

Header

ndis.h

See Also

Reference

NDIS 5.x Legacy Structures
NDIS_MAC_LINE_UP
NdisMIndicateStatus
NDIS 5.x Legacy Reference