NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

Die NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS-Struktur gibt die Parameter für einen Lesevorgang auf dem 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;

Angehörige

Header

Der Typ, die Überarbeitung 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 den Type Member 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 element RevisionHeader- auf den folgenden Wert festlegen:

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie das Size Member 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 Über Ressourcen verfügen, die zuvor über eine OID-Methodenanforderung von OID_NIC_SWITCH_ALLOCATE_VFzugeordnet wurden.

BlockId

Ein ULONG-Wert, der den Bezeichner des zu lesenden VF-Konfigurationsblocks angibt. Dieser Bezeichner ist eigentum an den unabhängigen Hardwareanbieter (IHV) und wird nur von den Miniporttreibern für pf und VF auf dem Netzwerkadapter verwendet.

Weitere Informationen finden Sie im Abschnitt "Hinweise".

Length

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

BufferOffset

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

Bemerkungen

Die NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS Struktur wird in OID-Methodenanforderungen von OID_SRIOV_READ_VF_CONFIG_BLOCKverwendet.

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 Miniport-Treiber, der im Gastbetriebssystem ausgeführt wird. Dieses Betriebssystem wird in einer Hyper-V untergeordneten Partition ausgeführt.
Der PF-Miniporttreiber, der im Verwaltungsbetriebssystem ausgeführt wird.
Dieses Betriebssystem wird innerhalb der Hyper-V übergeordneten Partition ausgeführt.

Hinweis Die Verwendung des VF-Konfigurationsblocks und das Format der Konfigurationsdaten werden vom unabhängigen Hardwareanbieter (IHV) des Geräts definiert. Die Konfigurationsdaten werden nur von den PF- und VF-Miniporttreibern verwendet.

Weitere Informationen zur Backchannel-Kommunikation innerhalb der einzelnen I/O-Virtualisierungsschnittstelle (SR-IOV) finden Sie unter SR-IOV PF/VF Backchannel Communication.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.30 und höher.
Header-	ntddndis.h (include Ndis.h)

Siehe auch

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK

Freigeben über