OID_GEN_RECEIVE_HASH

As a query, NDIS and overlying drivers use the OID_GEN_RECEIVE_HASH OID to obtain the current receive hash calculation settings of a miniport adapter. NDIS returns an NDIS_RECEIVE_HASH_PARAMETERS structure that contains the current receive hash settings.

As a set, NDIS and overlying drivers use the OID_GEN_RECEIVE_HASH OID to configure the receive hash calculations on a miniport adapter. The miniport driver receives an NDIS_RECEIVE_HASH_PARAMETERS structure.

Remarks

For NDIS miniport drivers, the query is not requested.

Support for this OID set is optional for miniport drivers, including those that support RSS.

An overlying driver can use the OID_GEN_RECEIVE_HASH OID to enable and configure hash calculations on received frames without enabling RSS.

Note  Protocol drivers must disable receive hash calculations before they enable RSS. If RSS is enabled, a protocol driver disables RSS before it enables receive hash calculations. A miniport driver should fail a set request with NDIS_STATUS_INVALID_OID or NDIS_STATUS_NOT_SUPPORTED to enable receive hash calculations if OID_GEN_RECEIVE_SCALE_PARAMETERS is currently enabled.

Note  The secret key is appended after the NDIS_RECEIVE_HASH_PARAMETERS structure members.

Requirements

Version

Supported in NDIS 6.0 and later.

Header

Ntddndis.h (include Ndis.h)

See also

NDIS_RECEIVE_HASH_PARAMETERS