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 de virtualização de E/S raiz única (SR-IOV).
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 passado como o Context membro da estrutura VPCI_INTERFACE_STANDARD para a interface.
BlockId
[in] O identificador do bloco de configuração de VF a ser lido. Esse identificador é proprietário do IHV (fornecedor de hardware independente) 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 por 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.
Nota
O valor desse parâmetro não deve exceder VPCI_MAX_READ_WRITE_BLOCK_SIZE.
Valor de retorno
A rotina readVfConfigBlock retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, a rotina retornará um valor NTSTATUS apropriado.
Observações
Quando a rotina de 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 Hyper-V.
- O driver PF, que é executado no sistema operacional de gerenciamento. Esse sistema operacional é executado na partição pai Hyper-V.
Os dados de cada bloco de configuração de VF são usados apenas pelos drivers do PF e do VF.
Nota
O IOCTL_VPCI_READ_BLOCK IOCTL oferece uma alternativa assíncrona à rotina de ReadVfConfigBlock.
Requisitos
| Requisito | Valor |
|---|---|
| servidor com suporte mínimo | Windows Server 2012 |
| cabeçalho | vpci.h |
| IRQL | <= APC_LEVEL |