NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS estrutura (ntddndis.h)

Artigo
02/07/2025

A estrutura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS especifica os parâmetros para uma operação de gravação 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 o VF e os drivers de miniporto PF (PCIe Physical Function).

Sintaxe

typedef struct _NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  NDIS_SRIOV_FUNCTION_ID VFId;
  ULONG                  BlockId;
  ULONG                  Length;
  ULONG                  BufferOffset;
} NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, *PNDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS;

Membros

Header

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

O driver deve definir o Type membro do de Cabeçalho para NDIS_OBJECT_TYPE_DEFAULT. Para especificar a versão da estrutura de NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS, o driver deve definir o membro de Revisão do de Cabeçalho com o seguinte valor:

NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1

Versão original do NDIS 6.30 e posterior.

Defina o membro tamanho como NDIS_SIZEOF_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS_REVISION_1.

VFId

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

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

BlockId

Um valor ULONG que especifica o identificador do bloco de configuração do VF a ser gravado. Esse identificador é proprietário do IHV (fornecedor de hardware independente) e é usado apenas pelos drivers de miniporto para o PF e 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 gravação.

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 a serem gravados no bloco de configuração de VF especificado.

Observações

A estrutura NDIS_SRIOV_WRITE_VF_CONFIG_BLOCK_PARAMETERS é usada em uma solicitação de conjunto OID de OID_SRIOV_WRITE_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 miniporto VF, que é executado no sistema operacional convidado. Esse sistema operacional é executado em uma partição filho Hyper-V.
O driver de miniporto 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 de miniporto PF e VF.

Para obter mais informações sobre a comunicação backchannel dentro da interface de virtualização de E/S raiz única (SR-IOV), consulte SR-IOVde Comunicação Backchannel PF/VF.

Requisitos

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

Consulte também

NDIS_OBJECT_HEADER

OID_SRIOV_WRITE_VF_CONFIG_BLOCK

Compartilhar via