Skip to content

Latest commit

 

History

History
100 lines (71 loc) · 2.96 KB

nc-pcivirt-sriov_read_config.md

File metadata and controls

100 lines (71 loc) · 2.96 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:pcivirt.SRIOV_READ_CONFIG
SRIOV_READ_CONFIG (pcivirt.h)
Reads data from the configuration space of the specified PCI Express SR-IOV Virtual Function (VF).
pci\sriov_read_config.htm
PCI
02/24/2018
SRIOV_READ_CONFIG callback
*PSRIOV_READ_CONFIG, *PSRIOV_READ_CONFIG callback function [Buses], PCI.sriov_read_config, SRIOV_READ_CONFIG, SRIOV_READ_CONFIG callback function [Buses], pcivirt/SRIOV_READ_CONFIG
pcivirt.h
Windows
Windows 10
Windows Server 2016
PASSIVE_LEVEL
Windows
PARCLASS_INFORMATION, *PPARCLASS_INFORMATION
SRIOV_READ_CONFIG
pcivirt/SRIOV_READ_CONFIG
APIRef
kbSyntax
UserDefined
Pcivirt.h
SRIOV_READ_CONFIG

SRIOV_READ_CONFIG callback

-description

Reads data from the configuration space of the specified PCI Express SR-IOV Virtual Function (VF).

-parameters

-param Context [in]

A pointer to a driver-defined context.

-param Data [out]

A pointer to buffer that contains the configuration information to be read from the VF's configuration space.

-param VfIndex [in]

A zero-based index of the VF to which this read operation applies.

-param Offset [in]

An offset in bytes to the start of the VF’s configuration space where the read begins.

-param Length [in]

The length, in bytes, of the data to read from the configuration space.

-returns

Return STATUS_SUCCESS if the operation succeeds. Otherwise, return an appropriate NTSTATUS error code.

-prototype

NTSTATUS  SRIOV_READ_CONFIG(
  _In_        PVOID  Context,
  _Out_ const VOID   *Data,
  _In_        USHORT VfIndex,
  _In_        ULONG  Offset,
  _In_        ULONG  Length
);

typedef SRIOV_READ_CONFIG *PSRIOV_READ_CONFIG;

-remarks

This callback function is implemented by the physical function (PF) driver. It is invoked when the system wants to read from the configuration space of a specific virtual function.

The PF driver registers its implementation by setting the ReadVfConfig member of the SRIOV_DEVICE_INTERFACE_STANDARD, configuring a WDF_QUERY_INTERFACE_CONFIG structure, and calling WdfDeviceAddQueryInterface.