SRIOV_READ_CONFIG função de retorno de chamada (pcivirt.h)

Artigo
02/07/2025

Lê dados do espaço de configuração do PCI Express SR-IOV Virtual Function (VF) especificado.

Sintaxe

SRIOV_READ_CONFIG SriovReadConfig;

NTSTATUS SriovReadConfig(
  [in]  PVOID Context,
  [out] PVOID Data,
  [in]  USHORT VfIndex,
  [in]  ULONG Offset,
  [in]  ULONG Length
)
{...}

Parâmetros

[in] Context

Um ponteiro para um contexto definido pelo driver.

[out] Data

Um ponteiro para o buffer que contém as informações de configuração a serem lidas do espaço de configuração do VF.

[in] VfIndex

Um índice baseado em zero da VF ao qual essa operação de leitura se aplica.

[in] Offset

Um deslocamento em bytes para o início do espaço de configuração da VF em que a leitura começa.

[in] Length

O comprimento, em bytes, dos dados a serem lidos do espaço de configuração.

Valor de retorno

Retorne STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS apropriado.

Observações

Essa função de retorno de chamada é implementada pelo driver de função física (PF). Ele é invocado quando o sistema deseja ler do espaço de configuração de uma função virtual específica.

O driver PF registra sua implementação definindo o membro ReadVfConfig do SRIOV_DEVICE_INTERFACE_STANDARD, configurando uma estrutura de WDF_QUERY_INTERFACE_CONFIG e chamando WdfDeviceAddQueryInterface.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	pcivirt.h
IRQL	PASSIVE_LEVEL

Compartilhar via