NDIS_MAC_FRAGMENT

  • Article

NDIS_MAC_FRAGMENT contains information associated with a fragment indication made by a WAN NIC miniport.

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.

See Also

NDIS_MAC_LINE_UP | NdisMIndicateStatus

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.