Compartilhar via

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

  • Artigo

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

Sintaxe

SRIOV_READ_BLOCK SriovReadBlock;

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

Parâmetros

[in] Context

Um ponteiro para um contexto definido pelo driver.

[in] VfIndex

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

[in] BlockId

Um número que identifica o bloco a ser lido. Isso é definido pelo provedor do driver PF.

[out] Buffer

Um ponteiro para um buffer que recebe os dados lidos do espaço de configuração do VF.

[in] Length

O comprimento em bytes dessa operação de leitura. Não deve ser maior que VPCI_MAX_READ_WRITE_BLOCK_SIZE definido em Pcivirt.h.

Retornar valor

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

Comentários

Essa função de retorno de chamada é implementada pelo driver de função física (PF). Ele é invocado quando o sistema deseja ler um bloco de configuração para um de seus VFs.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho pcivirt.h
IRQL PASSIVE_LEVEL