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

Artigo
02/07/2025

Recupera informações sobre a localização atual do dispositivo PCI no barramento, como Segmento PCI, Barramento, Dispositivo e Número de 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 da VF ao qual essa operação de leitura se aplica.

[out] SegmentNumber

Um ponteiro para uma variável preenchida com o número de 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 ainda mais onde neste barramento o dispositivo pode ser encontrado.

Valor de retorno

Nenhum

Observações

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 GetDeviceLocation membro 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