Compartilhar via

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

  • Artigo

Recupera informações sobre a localização atual do dispositivo PCI no barramento, como Segmento PCI, Barramento, Dispositivo e Número da Função.

Sintaxe

SRIOV_GET_DEVICE_LOCATION SriovGetDeviceLocation;

void SriovGetDeviceLocation(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PUINT16 SegmentNumber,
  [out] PUINT8 BusNumber,
  [out] PUINT8 FunctionNumber
)
{...}

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.

[out] SegmentNumber

Um ponteiro para uma variável preenchida com o Número do Segmento atual, que descreve o grupo de Barramentos PCI ao qual esse dispositivo está anexado.

[out] BusNumber

Um ponteiro para uma variável preenchida com o Número do Barramento atual, que descreve qual Barramento PCI ao qual esse dispositivo está anexado.

[out] FunctionNumber

Um ponteiro para uma variável que é preenchida com o FunctionNumber, que descreve mais detalhadamente onde nesse barramento o dispositivo pode ser encontrado.

Retornar valor

Nenhum

Comentários

Essa função de retorno de chamada é implementada pelo driver de função física (PF). Ele é invocado quando o sistema deseja recuperar o local do dispositivo.

O driver PF registra sua implementação definindo o membro GetDeviceLocation do SRIOV_DEVICE_INTERFACE_STANDARD, configurando uma estrutura 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