NDIS_SRIOV_VF_SERIAL_NUMBER_INFO structure (ntddndis.h)

The NDIS_SRIOV_VF_SERIAL_NUMBER_INFO structure contains the serial number associated with a PCI Express (PCIe) Virtual Function (VF) network adapter. This adapter is exposed in the guest operating system of a Hyper-V child partition.

Syntax

typedef struct _NDIS_SRIOV_VF_SERIAL_NUMBER_INFO {
  NDIS_OBJECT_HEADER Header;
  ULONG              SerialNumber;
} NDIS_SRIOV_VF_SERIAL_NUMBER_INFO, *PNDIS_SRIOV_VF_SERIAL_NUMBER_INFO;

Members

Header

The type, revision, and size of the NDIS_SRIOV_VF_SERIAL_NUMBER_INFO structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

NDIS sets the Type member of Header to NDIS_OBJECT_TYPE_DEFAULT. To specify the version of the NDIS_SRIOV_VF_SERIAL_NUMBER_INFO structure, NDIS sets the Revision member of Header to the following value:

NDIS_SRIOV_VF_SERIAL_NUMBER_INFO_REVISION_1

Original version for NDIS 6.30 and later.

Set the Size member to NDIS_SIZEOF_SRIOV_VF_SERIAL_NUMBER_INFO_REVISION_1.

SerialNumber

A ULONG value that specifies the serial number associated with the VF network adapter in a Hyper-V child partition. This value is generated by the virtualization stack that runs in the management operating system of the Hyper-V parent partition.

The serial number is unique across all VF adapters in the child partition. NDIS obtains the VF serial number from the underlying virtual PCI (VPCI) bus driver that runs in the guest operating system of the child partition.

Remarks

The NDIS_SRIOV_VF_SERIAL_NUMBER_INFO structure is used in OID query requests of OID_SRIOV_VF_SERIAL_NUMBER.

The virtualization stack uses the serial number to map the VF network adapter in a Hyper-V child partition to an instance of a VF on the physical network adapter. The virtualization stack creates the unique VF serial number before resources are allocated for the VF through an OID set request of OID_NIC_SWITCH_ALLOCATE_VF.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.30 and later.
Header ntddndis.h (include Ndis.h)

See also

NDIS_OBJECT_HEADER

OID_SRIOV_VF_SERIAL_NUMBER