NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS-Struktur (ntddndis.h)

Artikel
03/01/2024

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 den VF- und den PCIe Physical Function-Miniporttreibern (PF) 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;

Member

Header

Der Typ, die Revision 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 das Type-Element von Header auf NDIS_OBJECT_TYPE_DEFAULT festlegen. Um die Version der NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS-Struktur anzugeben, muss der Treiber das Revisionselement des Headers auf den folgenden Wert festlegen:

NDIS_SRIOV_WRITE_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_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 Objektbezeichner-Methodenanforderung (Object Identifier, OID) von OID_NIC_SWITCH_ALLOCATE_VF zugeordnet wurden.

BlockId

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

Hinweise

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

Freigeben über