SRIOV_READ_BLOCK Rückruffunktion (pcivirt.h)

Liest Daten aus dem angegebenen Konfigurationsblock eines PCI Express SR-IOV Virtual Function (VF).

Syntax

SRIOV_READ_BLOCK SriovReadBlock;

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

Parameter

[in] Context

Ein Zeiger auf einen vom Treiber definierten Kontext.

[in] VfIndex

Ein nullbasierter Index des VF, für den dieser Lesevorgang gilt.

[in] BlockId

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

[out] Buffer

Ein Zeiger auf einen Puffer, der die Daten empfängt, die aus dem Konfigurationsbereich des VF gelesen werden.

[in] Length

Die Länge in Byte dieses Lesevorgangs. 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 ReadVfConfigBlock 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