A queue pair is a transmit and receive queue on the network adapter that is assigned to the VPort.
#Virtual port driver driver
The overlying driver can also specify the number of queue pairs assigned to the VPort. Note The attachment of a nondefault VPort to a VF or PF cannot be changed after the nondefault VPort has been created. Otherwise, the value must be set to the identifier of a VF whose resources were previously allocated through an OID method request of OID_NIC_SWITCH_ALLOCATE_VF. The AttachedFunctionId member must be set to the identifier of the VF or PF on which the nondefault VPort is to be attached.Ī value of NDIS_PF_FUNCTION_ID specifies the PF. The VPortId member must be set to NDIS_DEFAULT_VPORT_ID. When creating a nondefault VPort, the overlying driver must set the SwitchId member to the NDIS_DEFAULT_SWITCH_ID identifier. This switch is known as the default NIC switch.
#Virtual port driver windows
Note Starting with Windows Server 2012, the SR-IOV interface supports only one NIC switch on the network adapter. The SwitchId member must be set to the identifier of a NIC switch that was previously created on the network adapter through an OID method request of OID_NIC_SWITCH_CREATE_SWITCH. When it initializes the NDIS_NIC_SWITCH_VPORT_PARAMETERS structure, the overlying driver must do the following: The configuration information includes the PCIe function to which the nondefault VPort is attached and the number of queue pairs for the nondefault VPort. The overlying driver initializes the NDIS_NIC_SWITCH_VPORT_PARAMETERS structure with the configuration information about the nondefault VPort to be created. After a successful return from the OID_NIC_SWITCH_CREATE_VPORT request, the VPortId member of the NDIS_NIC_SWITCH_VPORT_PARAMETERS structure has a VPort identifier that is unique across the VPorts on the NIC switch. The InformationBuffer member of the NDIS_OID_REQUEST structure contains a pointer to the NDIS_NIC_SWITCH_VPORT_PARAMETERS structure. This OID request also attaches the created VPort to the network adapter's PF or a previously allocated VF. Note Nondefault VPorts can only be created after the NIC switch has been created.Īn overlying driver issues an object identifier (OID) method request of OID_NIC_SWITCH_CREATE_VPORT to create a nondefault VPort on a specified NIC switch. For example, nondefault VPorts on the PF could be used to provide offload capabilities similar to the virtual machine queue (VMQ) interface. After it is created and attached to the VF, the nondefault VPort is in an activated state.Ī nondefault VPort that is attached to the PF provides additional network offload capabilities to the networking components that run in the management operating system. Nondefault VPorts may be attached to the PF or to a VF, and can only be created after the NIC switch has been created.Ī nondefault VPort that is attached to a VF provides network connectivity to the networking components that run in the guest operating system. An overlying driver, such as the virtualization stack, explicitly creates these ports by issuing OID method requests of OID_NIC_SWITCH_CREATE_VPORT. Nondefault VPorts are not created implicitly when the NIC switch is created.
#Virtual port driver how to
The PF miniport driver implicitly deletes the default VPort only when it deletes the default NIC switch.įor more information on how to create a NIC switch and the default VPort on the switch, see Creating a NIC Switch. The default VPort is always in an activated state and cannot be explicitly deleted. The default VPort cannot be attached to a VF. When the PF miniport driver creates and configures the default NIC switch, the driver implicitly creates the default VPort and attaches it to the PF. The default VPort has an identifier of NDIS_DEFAULT_VPORT_ID.
The default VPort provides network connectivity to the networking components that run in the management operating system.
The PF is attached to the Hyper-V parent partition and is exposed as a virtual network adapter in the management operating system that runs in that partition.Ī VF is attached to the Hyper-V child partition and is exposed as a virtual network adapter in the guest operating system that runs in that partition. One or more internal VPorts which are connected to the PCI Express (PCIe) Physical Function (PF) or Virtual Functions (VFs). One external physical port for connectivity to the external physical network. Each NIC switch has the following ports for network connectivity: A virtual port (VPort) is a data object that represents an internal port on the NIC switch of a network adapter that supports single root I/O virtualization (SR-IOV).
0 kommentar(er)
