estrutura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS (ntddndis.h)

  • Artigo

A estrutura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS especifica os parâmetros de uma operação de leitura no bloco de configuração da VF (Função Virtual) PCI Express (PCIe) de um adaptador de rede. Esses parâmetros são usados para a comunicação backchannel entre os drivers de miniporto para uma VF e a função física PCIe (PF).

Sintaxe

typedef struct _NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS;

Membros

Header

O tipo, a revisão e o tamanho da estrutura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS . Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .

O driver de miniporta deve definir o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS , o driver deve definir o membro Revision de Header com o seguinte valor:

NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro Size como NDIS_SIZEOF_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

Um valor NDIS_SRIOV_FUNCTION_ID que especifica o identificador exclusivo do VF no adaptador de rede.

Nota O VF com o valor de NDIS_SRIOV_FUNCTION_ID especificado deve ter recursos que foram alocados anteriormente por meio de uma solicitação de método OID de OID_NIC_SWITCH_ALLOCATE_VF.
 

BlockId

Um valor ULONG que especifica 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 de miniporto para o PF e o VF no adaptador de rede.

Para obter mais informações, consulte a seção Comentários.

Length

Um valor ULONG que especifica o comprimento, em unidades de bytes, da operação de leitura.

BufferOffset

Um valor ULONG que especifica o deslocamento, em unidades de bytes, desde o início dessa estrutura até um buffer que contém os dados lidos do bloco de configuração de VF especificado.

Comentários

A estrutura NDIS_SRIOV_READ_VF_CONFIG_BLOCK_PARAMETERS é usada em solicitações de método OID de OID_SRIOV_READ_VF_CONFIG_BLOCK.

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 de miniporta VF, que é executado no sistema operacional convidado. Esse sistema operacional é executado em uma partição filho do Hyper-V.
  • O driver de miniporta PF, que é executado no sistema operacional de gerenciamento.

    Esse sistema operacional é executado dentro da partição pai do Hyper-V.

Nota 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 de miniporta PF e VF.
 
Para obter mais informações sobre a comunicação backchannel dentro da interface sr-IOV (virtualização de E/S de raiz única), consulte Comunicação backchannel sr-IOV PF/VF.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.30 e posterior.
Cabeçalho ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OBJECT_HEADER

OID_SRIOV_READ_VF_CONFIG_BLOCK