estrutura VPCI_INVALIDATE_BLOCK_OUTPUT (vpci.h)

Artigo
02/07/2025

A estrutura de VPCI_INVALIDATE_BLOCK_OUTPUT é usada em uma solicitação IOCTL IOCTL_VPCI_INVALIDATE_BLOCK.

O driver de uma VF (função virtual) PCI Express (PCIe) emite o IOCTL_VPCI_INVALIDATE_BLOCK solicitação IOCTL para ser notificado sobre alterações nos dados em um ou mais blocos de configuração de VF. Quando a solicitação IOCTL é concluída, a estrutura VPCI_INVALIDATE_BLOCK_OUTPUT especifica quais blocos de configuração de VF foram alterados.

Observação A solicitação IOCTL IOCTL_VPCI_INVALIDATE_BLOCK é emitida pelo driver de uma VF PCIe em um dispositivo que dá suporte à interface de virtualização de E/S raiz única (SR-IOV).

Sintaxe

typedef struct _VPCI_INVALIDATE_BLOCK_OUTPUT {
  UINT64 BlockMask;
} VPCI_INVALIDATE_BLOCK_OUTPUT, *PVPCI_INVALIDATE_BLOCK_OUTPUT;

Membros

BlockMask

Um UINT64 valor que especifica uma máscara de bits para os primeiros 64 blocos de configuração de VF. Cada bit na máscara de bits corresponde a um bloco de configuração de VF. Se um bit for definido como um, os dados associados ao bloco de configuração de VF correspondente serão alterados.

Observações

Um bloco de configuração de VF é usado para comunicação backchannel entre os drivers do PCIe PF e um VF em um dispositivo que dá suporte à interface SR-IOV. Os dados de um bloco de configuração de VF podem ser trocados entre os seguintes drivers:

O driver VF, que é executado no sistema operacional convidado. Esse sistema operacional é executado em uma partição filho Hyper-V.
O driver PF, que é executado no sistema operacional de gerenciamento.
Esse sistema operacional é executado na partição pai Hyper-V.

Observação O uso do bloco de configuração do VF e o formato de seus dados de configuração são definidos pelo IHV (fornecedor independente de hardware) do dispositivo. Os dados de configuração são usados apenas pelos drivers do PF e do VF.

No entanto, recomendamos que os IHVs reservem os primeiros blocos de configuração de 64 VF para dados que podem ser alterados ocasionalmente.

Requisitos

Requisito	Valor
cabeçalho	vpci.h (inclua Vpci.h)

Consulte também

IOCTL_VPCI_INVALIDATE_BLOCK

Compartilhar via