SRIOV_WRITE_BLOCK Rückruffunktion (pcivirt.h)

Schreibt Daten in den angegebenen Konfigurationsblock eines PCI Express SR-IOV Virtual Function (VF).

Syntax

SRIOV_WRITE_BLOCK SriovWriteBlock;

NTSTATUS SriovWriteBlock(
  [in] PVOID Context,
  [in] USHORT VfIndex,
  [in] ULONG BlockId,
  [in] PVOID Buffer,
       ULONG Length
)
{...}

Parameter

[in] Context

Ein Zeiger auf einen vom Treiber definierten Kontext.

[in] VfIndex

Ein nullbasierter Index des VF, auf den dieser Schreibvorgang angewendet wird.

[in] BlockId

Eine Zahl, die den zu schreibenden Block identifiziert. Dies wird vom Anbieter des PF-Treibers definiert.

[in] Buffer

Ein Zeiger auf einen Puffer, der die Daten enthält, die in den Konfigurationsraum des VF geschrieben werden sollen.

Length

Die Länge in Byte dieses Schreibvorgangs. Darf nicht größer als VPCI_MAX_READ_WRITE_BLOCK_SIZE in Pcivirt.h definiert sein.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS- Fehlercode zurück.

Bemerkungen

Diese Rückruffunktion wird vom PF-Treiber (Physical Function) implementiert. Es wird aufgerufen, wenn das System einen Konfigurationsblock für eines seiner VFs lesen möchte.

Der PF-Treiber registriert seine Implementierung durch Festlegen des WriteVfConfigBlock Member des SRIOV_DEVICE_INTERFACE_STANDARD, Konfigurieren einer WDF_QUERY_INTERFACE_CONFIG-Struktur und Aufrufen WdfDeviceAddQueryInterface.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	pcivirt.h
IRQL-	PASSIVE_LEVEL