VPCI_WRITE_BLOCK Rückruffunktion (vpci.h)

Die WriteVfConfigBlock-Routine schreibt einen Block von Konfigurationsdaten für eine virtuelle PCI Express-Funktion (VF). Diese Routine wird vom Treiber eines PCIe VF auf einem Gerät aufgerufen, das die Single Root-E/A-Virtualisierungsschnittstelle (SINGLE Root I/O Virtualization, SR-IOV) unterstützt.

Syntax

VPCI_WRITE_BLOCK VpciWriteBlock;

NTSTATUS VpciWriteBlock(
  PVOID Context,
  ULONG BlockId,
  PVOID Buffer,
  ULONG Length
)
{...}

Parameter

Context

[in] Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Kontextelement der VPCI_INTERFACE_STANDARD-Struktur für die Schnittstelle übergeben wird.

BlockId

[in] Der Bezeichner des zu schreibenden VF-Konfigurationsblocks. Dieser Bezeichner ist eigentum des unabhängigen Hardwareherstellers (Independent Hardware Vendor, IHV) und wird nur von den Treibern für die physische PCIe-Funktion (PF) und VF auf dem Gerät verwendet.

Buffer

[in] Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die zu schreibenden Konfigurationsdaten enthält. Weitere Informationen finden Sie in den Hinweisen.

Length

[in] Die Anzahl der Bytes, die in den VF-Konfigurationsblock geschrieben werden sollen.

Rückgabewert

Die ReadVfConfigBlock-Routine gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Routine einen geeigneten NTSTATUS-Wert zurück.

Hinweise

Wenn die WriteVfConfigBlock-Routine aufgerufen wird, wird der Treiber der PF benachrichtigt, einen angegebenen VF-Konfigurationsblock mit den angegebenen Daten zu aktualisieren.

Ein VF-Konfigurationsblock wird für die Backchannelkommunikation zwischen den Treibern der PCIe-PF und einem VF auf einem Gerät verwendet, das die SR-IOV-Schnittstelle unterstützt. Die IHV kann einen oder mehrere VF-Konfigurationsblöcke für das Gerät definieren. Jeder VF-Konfigurationsblock hat ein IHV-definiertes Format, eine länge und eine Block-ID.

VF-Konfigurationsdaten können geschützt zwischen den folgenden Treibern ausgetauscht werden:

• Der VF-Treiber, der im Gastbetriebssystem ausgeführt wird. Dieses Betriebssystem wird in 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.

Daten aus jedem VF-Konfigurationsblock werden nur von den Treibern von PF und VF verwendet.

Anforderungen

Weitere Informationen

IOCTL_VPCI_WRITE_BLOCK

VPCI_INTERFACE_STANDARD