Share via


OID_TCP_OFFLOAD_PARAMETERS (Compact 7)

3/12/2014

As a set request, this 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 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 the overlying protocol drivers are updated with the new capabilities information.

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.

Requirements

Header

ntddndis.h

See Also

Reference

NDIS TCP/IP Offload OIDs
NDIS_OFFLOAD_PARAMETERS
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_HARDWARE_CAPABILITIES