Edit

NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

  • Article

The NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indicates to NDIS and overlying drivers that the current virtual machine (VM) queue parameters have changed on the network adapter.

Remarks

The miniport driver must issue an NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication when the current VM queue parameters have changed on the network adapter. The VM queue parameters could change when one of the following conditions is true:

  • The VM queue parameters are changed through a management application developed by the independent hardware vendor (IHV).

  • The VM queue parameters change for one or more network adapters that belong to a load balancing failover (LBFO) team managed by a MUX intermediate driver. For more information, see NDIS MUX Intermediate Drivers.

When the miniport driver issues the NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication, it must follow these steps:

  1. The miniport driver initializes an NDIS_RECEIVE_QUEUE_PARAMETERS structure with the current VM queue parameters on the network adapter. The driver must also set the Flags member of this structure with the appropriate NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED flags to report on NDIS_RECEIVE_QUEUE_PARAMETERS member values that have changed.

    Note Starting with NDIS 6.30, the miniport driver can only issue an NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication to report on changes to the InterruptCoalescingDomainId member.

When the miniport driver initializes the Header member of this structure, it sets the Type member of Header to NDIS_OBJECT_TYPE_DEFAULT. The miniport driver sets the Revision member of Header to NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 and the Size member to NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.

  1. The miniport driver initializes an NDIS_STATUS_INDICATION structure in the following way:

    • The StatusCode member must be set to NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS.

    • The StatusBuffer member must be set to the pointer to a NDIS_RECEIVE_QUEUE_PARAMETERS structure. This structure contains the currently enabled hardware capabilities of the NIC switch.

    • The StatusBufferSize member must be set to sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS).

  2. The miniport driver issues the status notification by calling NdisMIndicateStatusEx. The driver must pass a pointer to the NDIS_STATUS_INDICATION structure to the StatusIndication parameter.

Overlying drivers can use the NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication to determine the current VM queue parameters on the network adapter. Alternatively, these drivers can also issue object identifier (OID) query requests of OID_RECEIVE_FILTER_QUEUE_PARAMETERS to obtain these parameters at any time.

Requirements

Version

Supported in NDIS 6.30 and later.

Header

 Ndis.h

See also

NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS