estrutura VPCI_INTERFACE_STANDARD (vpci.h)

Artigo
08/08/2023

A estrutura de interface VPCI_INTERFACE_STANDARD permite que os drivers de dispositivo acessem blocos de dados de configuração específicos de uma VF (função virtual) PCI Express (PCIe) de dispositivos que dão suporte à interface sr-IOV (virtualização de E/S de raiz única).

Essa estrutura descreve a interface GUID_VPCI_INTERFACE_STANDARD .

Observação

O local do bloco de configuração do VF e o formato dos dados de configuração são definidos pelo IHV (fornecedor independente de hardware) do dispositivo. Eles são usados apenas pelos drivers da função física PCIe (PF) e do VF.

Sintaxe

typedef struct _VPCI_INTERFACE_STANDARD {
  USHORT                 Size;
  USHORT                 Version;
  PVOID                  Context;
  PINTERFACE_REFERENCE   InterfaceReference;
  PINTERFACE_DEREFERENCE InterfaceDereference;
  PVPCI_WRITE_BLOCK      WriteVfConfigBlock;
  PVPCI_READ_BLOCK       ReadVfConfigBlock;
  UINT32                 SerialNumber;
} VPCI_INTERFACE_STANDARD, *PVPCI_INTERFACE_STANDARD;

Membros

Size

O tamanho, em bytes, dessa estrutura.

Version

A versão da interface definida pelo driver.

Context

Um ponteiro para informações de contexto específicas da interface.

InterfaceReference

Um ponteiro para uma rotina InterfaceReference que incrementa a contagem de referência da interface.

InterfaceDereference

Um ponteiro para uma rotina InterfaceDereference que diminui a contagem de referência da interface.

WriteVfConfigBlock

Um ponteiro para uma rotina WriteVfConfigBlock que grava um bloco de dados de configuração para uma VF PCIe.

ReadVfConfigBlock

Um ponteiro para uma rotina ReadVfConfigBlock que lê um bloco de dados de configuração para uma VF PCIe.

SerialNumber

Um valor UINT32 que contém o número de série para a VF PCIe no dispositivo. A pilha de virtualização gera um número de série exclusivo para cada VF exposto no dispositivo.

Comentários

A interface GUID_VPCI_INTERFACE_STANDARD é fornecida pelo driver de barramento VPCI (PCI virtual) que cria os PDOs (objetos de dispositivo físico) que estão em camadas abaixo dos drivers carregados para as VFs. Esses drivers são carregados no sistema operacional convidado que é executado em uma partição filho do Hyper-V.

Um driver obtém um ponteiro para a estrutura VPCI_INTERFACE_STANDARD enviando um IRP IRP_MN_QUERY_INTERFACE para seu driver de barramento com InterfaceType definido como GUID_VPCI_INTERFACE_STANDARD.