Edit

Share via

OID_TCP_OFFLOAD_PARAMETERS

  • Article

Query requests are not supported.

As a set request, the OID_TCP_OFFLOAD_PARAMETERS OID sets the current TCP offload configuration of a miniport adapter. Protocol drivers or user-mode applications can set this OID to change the current TCP offload configuration. A system administrator can use this OID through the Microsoft Windows Management Instrumentation (WMI) interface.

Remarks

OID_TCP_OFFLOAD_PARAMETERS is required for miniport drivers that support TCP offloads and optional for other miniport drivers. If a miniport driver does not support this OID, the driver should return NDIS_STATUS_NOT_SUPPORTED.

The InformationBuffer member of the NDIS_OID_REQUEST structure contains an NDIS_OFFLOAD_PARAMETERS structure. If the contents of InformationBuffer are invalid, the miniport driver should return NDIS_STATUS_INVALID_DATA in response to this OID.

While NDIS processes this OID and before it passes the OID to the miniport driver, NDIS updates the miniport adapter's offload standardized keywords with the new settings.

Miniport drivers must use the contents of the NDIS_OFFLOAD_PARAMETERS structure to update the currently reported TCP offload capabilities. After the update, the miniport driver must report the current task offload capabilities with the NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG status indication. This status indication ensures that all of the overlying protocol drivers are updated with the new capabilities information.

This OID is a more comprehensive OID that instructs miniport drivers to turn certain offloads on or off. Most TCP/IP task offloads can be configured and activated with this OID. For some offloads, such as Rx Checksum or Rx IPSec, this OID serves as a configuration change and doesn't mean the offload will be operational immediately. To activate those offloads, the miniport driver must wait until it receives an OID_OFFLOAD_ENCAPSULATION Set request.

Before setting OID_TCP_OFFLOAD_PARAMETERS, the overlying applications or drivers can use the OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES OID to determine what capabilities a miniport adapter's hardware can support. Use OID_TCP_OFFLOAD_PARAMETERS to enable capabilities that are reported as not enabled by the OID_TCP_OFFLOAD_CURRENT_CONFIG OID.

See also

NDIS_OFFLOAD_PARAMETERS
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES

Requirements

Version: Windows Vista and later Header: Ntddndis.h (include Ndis.h)