OID_GEN_MAXIMUM_TOTAL_SIZE

As a query, the OID_GEN_MAXIMUM_TOTAL_SIZE OID specifies the maximum total packet length, in bytes, the NIC supports. This specification includes the header.

Version Information

Windows Vista and later versions of Windows
Supported.

NDIS 6.0 and later miniport drivers
Mandatory.

NDIS 5.1 miniport drivers
Mandatory.

Windows XP
Supported.

NDIS 5.1 miniport drivers
Mandatory.

Remarks

The returned length specifies the largest packet size for the underlying medium. Thus, the returned length depends on the particular medium. A protocol driver might use this returned length as a gauge to determine the maximum size packet that a miniport driver could forward to the protocol driver. If the protocol driver preallocates buffers, it allocates buffers accordingly. The returned length also specifies the largest packet that a protocol driver can pass to the NdisSendNetBufferLists function.

If the miniport driver for a NIC enables 802.1p packet priority(that is, the miniport driver specifies the NDIS_MAC_OPTION_8021P_PRIORITY bit in the OID_GEN_MAC_OPTIONS OID bitmask), then the miniport driver must specify its maximum total packet length as 4 bytes less than the maximum size of packets received or sent over the network. For example, if a NIC that has 802.1p packet priority enabled receives and sends packets on the wire that are 1514 bytes in length, the miniport driver for the NIC must report its maximum total packet length as 1510 bytes. The miniport driver must never indicate up to the bound protocol driver packets received over the network that are longer than the packet size specified by OID_GEN_MAXIMUM_TOTAL_SIZE. That is, even if the miniport driver receives packets over the network that are not marked with priority values but are still the maximum size that the underlying medium supports, the miniport driver can only indicate up packets that are no longer than the size specified by OID_GEN_MAXIMUM_TOTAL_SIZE.

Requirements

Header

Ntddndis.h (include Ndis.h)

See also

NdisSendNetBufferLists

OID_GEN_MAC_OPTIONS