NDIS_HD_SPLIT_CURRENT_CONFIG - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddndis.h
typedef struct _NDIS_HD_SPLIT_CURRENT_CONFIG {
NDIS_OBJECT_HEADER Header;
ULONG HardwareCapabilities;
ULONG CurrentCapabilities;
ULONG HDSplitFlags;
ULONG HDSplitCombineFlags;
ULONG BackfillSize;
ULONG MaxHeaderSize;
} NDIS_HD_SPLIT_CURRENT_CONFIG, *PNDIS_HD_SPLIT_CURRENT_CONFIG;
View the official Windows Driver Kit DDI referenceNo description available.
The NDIS_HD_SPLIT_CURRENT_CONFIG structure provides the current header-data split configuration of a miniport adapter.
HeaderThe NDIS_OBJECT_HEADER structure for the NDIS_HD_SPLIT_CURRENT_CONFIG structure. The driver sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_HD_SPLIT_CURRENT_CONFIG_REVISION_1, and the Size member to NDIS_SIZEOF_HD_SPLIT_CURRENT_CONFIG_REVISION_1.
HardwareCapabilitiesThe header-data split hardware capabilities that the miniport adapter supports. These capabilities should include capabilities that are currently disabled by INF file settings or through the Advanced properties page. The value of HardwareCapabilities is a bitwise OR of the following flags:
The miniport adapter can split the header and data into separate memory descriptor lists (MDLs) that meet the requirements for header-data split support.
The miniport adapter can split IPv4 Ethernet frames that include IPv4 options. The miniport adapter can support splitting some IPv4 options while not splitting others.
Note The NIC must not split IPv4 frames that contain unsupported IPv4 options. If an IPv4 frame is split, the header portion of the split frame must contain the entire IPv4 header and all of the IPv4 options that are present.
The miniport adapter can split IPv6 Ethernet frames that include IPv6 extension headers. The miniport adapter can support some IPv6 extension headers while not supporting others.
Note The NIC must not split IPv6 frames that contain unsupported IPv6 extension headers. If an IPv6 frame is split, the header portion of the split frame must contain the entire IPv6 header and all of the IPv6 extension headers that are present.
The miniport adapter can split TCP frames with other TCP options in addition to the timestamp option. The miniport adapter can support some TCP options and not support others.
Note If the only TCP option in a frame is the timestamp option, the data-split provider must be able to split the frame.
Note If a TCP header contains an unsupported TCP option, the NIC must split the frame at the beginning of the TCP header or must not split the frame.
CurrentCapabilitiesThe current header-data split capabilities that the miniport adapter supports. The miniport driver uses the same flags that are defined for the HardwareCapabilities member. In this case, the flags are set to indicate the current capabilities that depend on the current configuration settings.
HDSplitFlagsA set of flags that reports the status of header-data split for a miniport adapter. NDIS sets this member with a bitwise OR of the following flags:
The miniport driver has enabled header-data split in the hardware. Otherwise, header-data split is disabled.
HDSplitCombineFlagsA set of flags that specify the current header-data split settings of a miniport adapter. The value of HDSplitCombineFlags can be a bitwise OR of the following flags:
The miniport adapter is combining split frames. If header-data split is enabled in the hardware, the miniport driver should combine the header and data before indicating the frame to NDIS.
BackfillSizeThe backfill size, in bytes, that the miniport driver is using for the data portion of a split frame.
MaxHeaderSizeThe maximum size, in bytes, that the miniport driver is using for the header portion of a split frame.
Note If the length of a header exceeds MaxHeaderSize because of the presence of IPv4 options, IPsec headers, or IPv6 extension headers, the frame must not be split. If a header that includes a TCP or UDP header exceeds MaxHeaderSize because of the presence of TCP header, TCP options, or UDP header, the NIC must split the frame at the beginning of the upper layer protocol header or must not split the frame.
The NDIS_HD_SPLIT_CURRENT_CONFIG structure is used in the OID_GEN_HD_SPLIT_CURRENT_CONFIG OID query request to obtain the current header-data split configuration of a miniport adapter.
OID_GEN_HD_SPLIT_CURRENT_CONFIG