SRIOV_READ_BLOCK Rückruffunktion (pcivirt.h)

Artikel
02/26/2024

Liest Daten aus dem angegebenen Konfigurationsblock einer 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 aus dem Konfigurationsraum des Vf gelesenen Daten empfängt.

[in] Length

Die Länge dieses Lesevorgangs in Bytes. Darf nicht größer als VPCI_MAX_READ_WRITE_BLOCK_SIZE sein, der in Pcivirt.h definiert ist.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Diese Rückruffunktion wird vom Treiber der physischen Funktion (PF) implementiert. Sie wird aufgerufen, wenn das System einen Konfigurationsblock für eines seiner VFs lesen möchte.

Der PF-Treiber registriert seine Implementierung, indem er den ReadVfConfigBlock-Member des SRIOV_DEVICE_INTERFACE_STANDARD festlegt, eine WDF_QUERY_INTERFACE_CONFIG-Struktur konfiguriert und WdfDeviceAddQueryInterface aufruft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	pcivirt.h
IRQL	PASSIVE_LEVEL

Freigeben über