VPCI_READ_BLOCK função de retorno de chamada (vpci.h)

A rotina ReadVfConfigBlock lê um bloco de dados de configuração para uma VF (função virtual) PCI Express (PCIe). Essa rotina é chamada pelo driver de uma VF PCIe em um dispositivo que dá suporte à interface SR-IOV (virtualização de E/S de raiz única).

Sintaxe

VPCI_READ_BLOCK VpciReadBlock;

NTSTATUS VpciReadBlock(
  PVOID Context,
  ULONG BlockId,
  PVOID Buffer,
  ULONG Length
)
{...}

Parâmetros

Context

[in] Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor que é passado como o membro Context da estrutura VPCI_INTERFACE_STANDARD para a interface.

BlockId

[in] O identificador do bloco de configuração do VF a ser lido. Esse identificador é proprietário do IHV (fornecedor independente de hardware) e é usado apenas pelos drivers para a função física PCIe (PF) e VF no dispositivo.

Buffer

[out] Um ponteiro para um buffer alocado pelo chamador que conterá os dados de configuração a serem lidos. Para obter mais informações, consulte Comentários.

Length

[in] O número de bytes a serem lidos do bloco de configuração do VF.

Retornar valor

A rotina ReadVfConfigBlock retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, a rotina retornará um valor NTSTATUS apropriado.

Comentários

Quando a rotina ReadVfConfigBlock é chamada, o driver do PF é notificado para retornar dados de um bloco de configuração de VF especificado.

Um bloco de configuração de VF é usado para comunicação backchannel entre os drivers do PF e um VF em um dispositivo que dá suporte à interface SR-IOV. O IHV pode definir um ou mais blocos de configuração de VF para o dispositivo. Cada bloco de configuração de VF tem um formato definido por IHV, comprimento e ID de bloco.

Os dados de configuração do VF podem ser trocados entre os seguintes drivers de maneira protegida:

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

Os dados de cada bloco de configuração de VF são usados apenas pelos drivers do PF e do VF.

Requisitos

Confira também

IOCTL_VPCI_READ_BLOCK

VPCI_INTERFACE_STANDARD