Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 einzelne I/O-Virtualisierungsschnittstelle (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 Context Member der VPCI_INTERFACE_STANDARD-Struktur für die Schnittstelle übergeben wird.
BlockId
[in] Der Bezeichner des VF-Konfigurationsblocks, der geschrieben werden soll. Dieser Bezeichner ist eigentum an den unabhängigen Hardwareanbieter (IHV) und wird nur von den Treibern für die PHYSISCHE Funktion PCIe (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.
Anmerkung
Der Wert dieses Parameters darf VPCI_MAX_READ_WRITE_BLOCK_SIZEnicht überschreiten.
Rückgabewert
Die ReadVfConfigBlock- Routine gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Routine einen entsprechenden NTSTATUS-Wert zurück.
Bemerkungen
Wenn die WriteVfConfigBlock- Routine aufgerufen wird, wird der Treiber der PF benachrichtigt, um einen angegebenen VF-Konfigurationsblock mit den angegebenen Daten zu aktualisieren.
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. Der IHV kann einen oder mehrere VF-Konfigurationsblöcke für das Gerät definieren. Jeder VF-Konfigurationsblock verfügt über ein IHV-definiertes Format, eine Länge und eine Block-ID.
VF-Konfigurationsdaten können zwischen den folgenden Treibern geschützt ausgetauscht werden:
- Der VF-Treiber, der im Gastbetriebssystem ausgeführt wird. Dieses Betriebssystem wird in einer Hyper-V untergeordneten Partition ausgeführt.
- Der PF-Treiber, der im Verwaltungsbetriebssystem ausgeführt wird. Dieses Betriebssystem wird innerhalb der Hyper-V übergeordneten Partition ausgeführt.
Daten aus jedem VF-Konfigurationsblock werden nur von den Treibern der PF und VF verwendet.
Anmerkung
Die IOCTL_VPCI_WRITE_BLOCK IOCTL bietet eine asynchrone Alternative zur WriteVfConfigBlock Routine.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Server- | Windows Server 2012 |
| Header- | gci.h |
| IRQL- | <= DISPATCH_LEVEL |