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.
Hinweis
Der Wert dieses Parameters darf VPCI_MAX_READ_WRITE_BLOCK_SIZE nicht überschreiten.
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.
Hinweis
Die IOCTL_VPCI_WRITE_BLOCK IOCTL bietet eine asynchrone Alternative zur WriteVfConfigBlock-Routine .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Kopfzeile | vpci.h |
| IRQL | <= DISPATCH_LEVEL |