Palavras-chave INF padronizadas para SR-IOV
Este tópico descreve as palavras-chave INF padronizadas para a interface sr-IOV (virtualização de E/S) raiz única. Essas palavras-chave se aplicam ao arquivo INF para o driver de miniporto da PF (Função Física) PCI Express (PCIe) de um adaptador de rede SR-IOV.
As palavras-chave SR-IOV INF são descritas nas seguintes seções:
Palavras-chave INF padronizadas para habilitar ou desabilitar o suporte a SR-IOV
Palavras-chave INF padronizadas para configuração do comutador NIC padrão
Palavras-chave INF padronizadas para habilitar ou desabilitar o suporte a SR-IOV
As palavras-chave INF padronizadas são definidas para habilitar ou desabilitar o suporte para os recursos SR-IOV de um adaptador de rede.
*SRIOV
Um valor que descreve se o dispositivo habilitou ou desabilitou o recurso SR-IOV.
Depois que o driver é instalado, os administradores podem atualizar o valor de *SRIOV palavra-chave na página de propriedades Avançado para o adaptador de rede. Para obter mais informações sobre propriedades avançadas, consulte Especificando parâmetros de configuração para a página Propriedades Avançadas.
Nota O driver de miniporte é reiniciado automaticamente depois que uma alteração é feita na página de propriedades Avançado para o adaptador.
*SriovPreferred
Um valor que define se os recursos SR-IOV devem ser habilitados em vez de VMQ (fila de máquinas virtuais) ou recursos de RSS (dimensionamento lateral de recebimento).
Esse é um valor de palavra-chave oculto que não deve ser especificado no arquivo INF e não é exibido na página de propriedades Avançado para o adaptador de rede.
Para obter mais informações sobre como interpretar palavras-chave SR-IOV, VMQ e RSS, consulte Manipulando palavras-chave SR-IOV, VMQ e RSS Standardized INF.
As palavras-chave INF padronizadas do SR-IOV são palavras-chave de enumeração e são descritas na tabela a seguir. As colunas nesta tabela descrevem os seguintes atributos para uma enumeração palavra-chave:
SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF. Esse nome também aparece no registro na chave NDI\params\ para o adaptador de rede.
Paramdesc
O texto de exibição associado ao palavra-chave SubkeyName.
Nota O IHV (fornecedor independente de hardware) pode definir qualquer texto descritivo para o SubkeyName.
Valor
O valor inteiro de enumeração associado a cada SubkeyName palavra-chave na lista.
EnumDesc
O texto de exibição associado a cada valor que aparece no menu.
| SubkeyName | Paramdesc | Valor | EnumDesc |
|---|---|---|---|
| *SRIOV | SR-IOV | 0 | Desabilitado |
| 1 (Padrão) | habilitado | ||
| *SriovPreferred | As entradas ParamDesc e EnumDesc para essa subchave não podem ser usadas em arquivos INF ou em uma interface do usuário. | 0 (padrão) | Relatar recursos RSS ou VMQ com base no palavra-chave *VmqOrRssPreferrence. Não relate as funcionalidades do SR-IOV. Para obter mais informações sobre o palavra-chave *VmqOrRssPreferrence, consulte Palavras-chave INF padronizadas para VMQ. |
| 1 | Relatar recursos sr-IOV. |
Para obter mais informações sobre palavras-chave INF padronizadas, consulte Palavras-chave INF padronizadas para dispositivos de rede.
Palavras-chave INF padronizadas para configuração do comutador NIC padrão
A partir do Windows Server 2012, a interface SR-IOV dá suporte a apenas uma opção NIC no adaptador de rede. Essa opção é conhecida como a opção NIC padrão e é referenciada pelo identificador NDIS_DEFAULT_SWITCH_ID.
O arquivo INF para o driver de miniporto PF deve especificar a configuração do comutador NIC padrão no adaptador de rede SR-IOV. Isso permite que o instalador de rede copie as informações de configuração de comutador padrão do INF para a configuração do registro de miniporte sob a subchave para o comutador padrão (NDI\params\NicSwitches\0).
Essas palavras-chave não são exibidas na página de propriedades Avançado para o adaptador de rede e não podem ser configuradas pelo usuário. Essas palavras-chave são especificadas usando a diretiva AddReg na seção DDInstall do arquivo INF. Cada palavra-chave é especificado por uma diretiva AddReg separada.
A tabela a seguir descreve as palavras-chave INF para a configuração de comutador NIC padrão do adaptador de rede SR-IOV. As colunas nesta tabela descrevem os seguintes atributos para estas palavras-chave:
SubkeyName
O nome do palavra-chave que você deve especificar no arquivo INF. Esse nome também aparece no registro na chave NDI\params\NicSwitches\0 para o adaptador de rede.
Valor de dados
O valor associado ao palavra-chave SubkeyName.
Tipo de dados
O tipo do valor de dados.
| SubkeyName | Valor de dados | Tipo de dados | Observações |
|---|---|---|---|
| *Sinalizadores | 0 | REG_DWORD | O palavra-chave deve ser atribuído a esse valor. |
| *Switchtype | 1 | REG_DWORD | O palavra-chave deve ser atribuído a esse valor. |
| *SwitchId | 0 | REG_DWORD | O palavra-chave deve ser atribuído a esse valor. |
| *Switchname | "Comutador Padrão" | REG_SZ | O palavra-chave deve ser atribuído a esse valor. |
| *NumVFs | (0-n), | REG_DWORD | n é o número máximo de VFs (PcIe Virtual Functions) compatíveis com o adaptador de rede SR-IOV. Nota Essa chave do Registro define o número máximo de VFs compatíveis com o adaptador de rede. Quando o driver de miniporto chama NdisMSetMiniportAttributes, ele pode anunciar menos do que esse valor dependendo dos recursos de hardware disponíveis no adaptador de rede. Para obter mais informações, consulte Determinando as funcionalidades de comutador nic. |
Veja a seguir um exemplo de diretivas AddReg para a configuração de comutador NIC padrão de um adaptador de rede SR-IOV:
HKR, NicSwitches\0, *SwitchId, 0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”
Para obter mais informações sobre a sintaxe da diretiva AddReg , consulte Diretiva AddReg do INF.
Para obter mais informações sobre a opção NIC padrão, consulte Comutadores NIC.