Share via


NDIS_MAC_FRAGMENT (Windows Embedded CE 6.0)

1/6/2010

NDIS_MAC_FRAGMENT contains information associated with a fragment indication made by a WAN NIC 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, using the binary OR operator:

    Error Flag Description

    WAN_ERROR_CRC

    Specifies a CRC error was encountered for a particular 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 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 virtual channel. Hardware overruns occur when the WAN NIC cannot handle the rate at which data is received.

    WAN_ERROR_BUFFEROVERRUN

    Specifies a buffer overrun was encountered for a particular 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 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 virtual channel. Alignment errors occur when a byte received is different 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 preceding error flags exists, choose the most appropriate flag or combination of flags.

Remarks

A WAN NIC driver calls NdisMIndicateStatus with this type 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
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Structures
NDIS_MAC_LINE_UP
NdisMIndicateStatus