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

See Also

Reference

NDIS Structures
NDIS_MAC_LINE_UP
NdisMIndicateStatus