NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur (ntddndis.h)

Artikel
02/29/2024

Die NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur gibt die Parameter für einen Lesevorgang im Konfigurationsblock der PCI Express (PCIe) Virtual Function (VF) eines Netzwerkadapters an. Diese Parameter werden für die Backchannel-Kommunikation zwischen den Miniporttreibern für einen VF und der PCIe Physical Function (PF) verwendet.

Syntax

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

Member

Header

Der Typ, die Revision und die Größe der NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur . Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Ursprüngliche Version für NDIS 6.30 und höher.

Legen Sie das Element Größe auf NDIS_SIZEOF_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1 fest.

VFId

Ein NDIS_SRIOV_FUNCTION_ID Wert, der den eindeutigen Bezeichner des VF auf dem Netzwerkadapter angibt.

Hinweis Der VF mit dem angegebenen NDIS_SRIOV_FUNCTION_ID-Wert muss Ressourcen aufweisen, die zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet wurden.

BlockId

Ein ULONG-Wert, der den Bezeichner des zu lesenden VF-Konfigurationsblocks angibt. Dieser Bezeichner ist für den unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) geschützt und wird nur von den Miniporttreibern für die PF und VF auf dem Netzwerkadapter verwendet.

Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Length

Ein ULONG-Wert, der die Länge des Lesevorgangs in Byteseinheiten angibt.

BufferOffset

Ein ULONG-Wert, der den Offset in Byteseinheiten vom Anfang dieser Struktur zu einem Puffer angibt, der die Daten enthält, die aus dem angegebenen VF-Konfigurationsblock gelesen werden.

Hinweise

Die NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur wird in OID-Methodenanforderungen von OID_SRIOV_READ_VF_CONFIG_BLOCK verwendet.

Ein VF-Konfigurationsblock wird für die Backchannel-Kommunikation zwischen den Treibern der PCIe-PF und einem VF auf einem Gerät verwendet, das die SR-IOV-Schnittstelle unterstützt. Daten aus einem VF-Konfigurationsblock können zwischen den folgenden Treibern ausgetauscht werden:

Der VF-Miniporttreiber, der im Gastbetriebssystem ausgeführt wird. Dieses Betriebssystem wird innerhalb einer untergeordneten Hyper-V-Partition ausgeführt.
Der PF-Miniporttreiber, der im Verwaltungsbetriebssystem ausgeführt wird.
Dieses Betriebssystem wird innerhalb der übergeordneten Hyper-V-Partition ausgeführt.

Hinweis Die Verwendung des VF-Konfigurationsblocks und das Format seiner Konfigurationsdaten werden vom unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) des Geräts definiert. Die Konfigurationsdaten werden nur von den Pf- und VF-Miniporttreibern verwendet.

Weitere Informationen zur Backchannelkommunikation innerhalb der SR-IOV-Schnittstelle (Single Root E/O Virtualization) finden Sie unter SR-IOV PF/VF Backchannel Communication.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Kopfzeile	ntddndis.h (include Ndis.h)

Weitere Informationen

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK

Freigeben über