NdisMWriteConfigBlock-Funktion (ndis.h)

  • Artikel

Ein Miniporttreiber für eine VIRTUELLE FUNKTION (PCI Express, PCIe) ruft die NdisMWriteConfigBlock-Funktion auf, um Daten in einen VF-Konfigurationsblock zu schreiben. Schreibvorgänge für einen VF-Konfigurationsblock werden vom Miniporttreiber der PCIe Physical Function (PF) des Netzwerkadapters verarbeitet.

Hinweis: NdisMWriteConfigBlock darf nur vom Miniporttreiber für den VF eines Netzwerkadapters aufgerufen werden.
 

Syntax

NDIS_STATUS NdisMWriteConfigBlock(
  [in] NDIS_HANDLE NdisMiniportHandle,
  [in] ULONG       BlockId,
  [in] PVOID       Buffer,
  [in] ULONG       Length
);

Parameter

[in] NdisMiniportHandle

Das Netzwerkadapterhandle, das NDIS an den MiniportAdapterHandle-Parameter von MiniportInitializeEx übergeben hat.

[in] BlockId

Ein ULONG-Wert, der den Bezeichner des Konfigurationsblocks angibt, in den geschrieben werden soll. Dieser Bezeichner ist eigentum des unabhängigen Hardwareanbieters (Independent Hardware Vendor, IHV) und wird nur von den Miniporttreibern für die PF und VF auf dem Netzwerkadapter verwendet.

[in] Buffer

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die zu schreibenden Konfigurationsdaten enthält.

[in] Length

Die Anzahl der Bytes, die in den Konfigurationsblock geschrieben werden sollen.

Rückgabewert

NdisMWriteConfigBlock kann einen der folgenden status-Werte zurückgeben.

Rückgabecode Beschreibung
NDIS_STATUS_SUCCESS
 Der Schreibvorgang wurde erfolgreich abgeschlossen.
NDIS_STATUS_FAILURE
 Fehler beim Schreibvorgang.

Hinweise

Der VF-Miniporttreiber ruft NdisMWriteConfigBlock auf, um eine Backchannel-Schreibanforderung von VF-Konfigurationsdaten durch den PF-Miniporttreiber zu initiieren. Nach der Benachrichtigung über diese Anforderung schreibt der PF-Treiber die Daten in den angegebenen VF-Konfigurationsblock.

Ein VF-Konfigurationsblock wird für die Backchannelkommunikation zwischen den PF- und VF-Miniporttreibern verwendet. 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.

Hinweis Daten aus jedem VF-Konfigurationsblock werden nur von den PF- und VF-Miniporttreibern verwendet.
 
Weitere Informationen zur Backchannelkommunikation innerhalb der SR-IOV-Schnittstelle (Single Root I/O Virtualization) finden Sie unter SR-IOV PF/VF Backchannel Communication.

Interfacing to a Virtual Bus Driver

Wenn ein unabhängiger Hardwareanbieter (IHV) einen virtuellen Bustreiber (VBD) als Teil seines SR-IOV-Treiberpakets bereitstellt, darf sein Miniporttreiber NdisMWriteConfigBlock nicht aufrufen. Stattdessen muss der Treiber über einen privaten Kommunikationskanal mit dem VBD kommunizieren und anfordern, dass der VBD WriteVfConfigBlock aufruft. Diese Funktion wird über die GUID_VPCI_INTERFACE_STANDARD-Schnittstelle verfügbar gemacht, die vom zugrunde liegenden VPCI-Bustreiber (Virtual PCI) unterstützt wird.

Die VBD, die im Gastbetriebssystem einer untergeordneten Hyper-V-Partition ausgeführt wird, kann die GUID_VPCI_INTERFACE_STANDARD-Schnittstelle abfragen, indem sie eine IRP_MN_QUERY_INTERFACE Anforderung an das objekt des physischen Geräts (PDO) im VPCI-Bus ausgibt. Diese Anforderung muss über IRQL = PASSIVE_LEVEL erfolgen. In dieser Anforderung muss der Treiber den Parameter InterfaceType auf GUID_VPCI_INTERFACE_STANDARD festlegen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Keine unterstützt, unterstützt in NDIS 6.30 und höher.
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Universell
Header ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL <= APC_LEVEL

Weitere Informationen

GUID_VPCI_INTERFACE_STANDARD

WriteVfConfigBlock