VPCI_WRITE_BLOCK_INPUT-Struktur (vpci.h)

Die VPCI_WRITE_BLOCK_INPUT-Struktur wird in einer IOCTL_VPCI_WRITE_BLOCK IOCTL-Anforderung verwendet, um Daten in einen angegebenen Konfigurationsblock für eine PCI Express (PCIe) Virtual Function (VF) zu schreiben.

Diese IOCTL-Anforderung wird vom Treiber eines PCIe VF auf einem Gerät ausgegeben, das die SR-IOV-Schnittstelle (Single Root E/O Virtualization) unterstützt.

Syntax

typedef struct _VPCI_WRITE_BLOCK_INPUT {
  ULONG BlockId;
  ULONG DataLength;
  UCHAR Data[ANYSIZE_ARRAY];
} VPCI_WRITE_BLOCK_INPUT, *PVPCI_WRITE_BLOCK_INPUT;

Member

BlockId

Ein ULONG-Wert , der den zu lesenden VF-Konfigurationsblock angibt. Dieser Wert wird vom Treiber für die physische PCIe-Funktion (PF) des Geräts definiert.

DataLength

Die Größe der Daten, die aus dem Datenmember geschrieben werden sollen, in Bytes.

Data[ANYSIZE_ARRAY]

Ein Array mit variabler Größe, das die Daten enthält, die in den Konfigurationsblock geschrieben werden sollen, der vom BlockId-Element angegeben wird.

Hinweise

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-Treiber, der im Gastbetriebssystem ausgeführt wird. Dieses Betriebssystem wird innerhalb einer untergeordneten Hyper-V-Partition ausgeführt.
• Der PF-Treiber, 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 Treibern der PF und VF verwendet.

 

Anforderungen

Anforderung	Wert
Header	vpci.h (include Vpci.h)

Weitere Informationen

IOCTL_VPCI_WRITE_BLOCK