NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS Struktur (ntddndis.h)

Artikel
02/07/2025

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

Syntax

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

Der Treiber muss den Type Member des Header- auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS-Struktur anzugeben, muss der Treiber den Revision Member Header- auf den folgenden Wert festlegen:

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Originalversion für NDIS 6.30 und höher.

Legen Sie den Size Member auf NDIS_SIZEOF_SRIOV_WRITE_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 (Object Identifier) von OID_NIC_SWITCH_ALLOCATE_VFzugeordnet wurden.

BlockId

Ein ULONG-Wert, der den Bezeichner des VF-Konfigurationsblocks angibt, in den geschrieben werden soll. 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 Schreibvorgangs 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 in den angegebenen VF-Konfigurationsblock geschrieben werden sollen.

Bemerkungen

Die NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS Struktur wird in einer OID-Satzanforderung von OID_SRIOV_WRITE_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_WRITE_VF_CONFIG_BLOCK

Freigeben über