SRIOV_WRITE_BLOCK Rückruffunktion (pcivirt.h)

Artikel
02/29/2024

Schreibt Daten in den angegebenen Konfigurationsblock einer 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, für den dieser Schreibvorgang gilt.

[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 dieses Schreibvorgangs 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 für die physische 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 WriteVfConfigBlock-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