NDIS_STATUS_NIC_SWITCH_CURRENT_CAPABILITIES

The NDIS_STATUS_NIC_SWITCH_CURRENT_CAPABILITIES status indicates to NDIS and overlying drivers that the currently enabled hardware capabilities of the NIC switch in a network adapter have changed.

The status indication is made by the miniport driver of the network adapter's PCI Express (PCIe) Physical Function (PF). The PF miniport driver runs in the management operating system of the Hyper-V parent partition.

Remarks

The PF miniport driver must issue an NDIS_STATUS_NIC_SWITCH_CURRENT_CAPABILITIES status indication whenever it detects a change to the currently enabled hardware capabilities of the NIC switch on the network adapter. These capabilities could change when one of the following conditions is true:

• The currently enabled NIC switch hardware capabilities are changed through a management application developed by the independent hardware vendor (IHV).

• The currently enabled NIC switch hardware capabilities 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 PF miniport driver issues the NDIS_STATUS_NIC_SWITCH_CURRENT_CAPABILITIES status indication, it must follow these steps:

1. The miniport driver initializes an NDIS_NIC_SWITCH_CAPABILITIES structure with the currently enabled hardware capabilities of the network adapter's NIC switch.

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

   • The StatusCode member must be set to NDIS_STATUS_NIC_SWITCH_CURRENT_CAPABILITIES.

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

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

3. The PF 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_NIC_SWITCH_CURRENT_CAPABILITIES status indication to determine the currently enabled NIC switch capabilities on the network adapter. Alternatively, these drivers can also issue OID query requests of OID_NIC_SWITCH_CURRENT_CAPABILITIES to obtain these capabilities at any time.

Requirements

See also

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_STATUS_INDICATION

OID_NIC_SWITCH_CURRENT_CAPABILITIES