Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este tópico descreve as diretrizes para escrever uma função MiniportInitializeEx para o driver de miniport da Função Física (PF) PCI Express (PCIe). O PF é um componente de um adaptador de rede que suporta virtualização de E/S de raiz única (SR-IOV).
Nota Estas orientações aplicam-se apenas aos condutores de miniportos PF. Para obter diretrizes de inicialização para o driver de miniporta de uma função virtual PCIe (VF) do adaptador, consulte inicializando um driver de miniporta VF.
O driver de miniporta PF segue as mesmas etapas que qualquer driver de miniporta NDIS quando sua função MiniportInitializeEx . Para obter mais informações sobre essas etapas, consulte inicializando um driver de miniporta.
Além dessas etapas, o driver de miniporta PF deve seguir estas etapas adicionais quando o NDIS chamar a função MiniportInitializeEx do driver:
O driver de miniporta PF chama a função NdisGetHypervisorInfo para verificar se ela está sendo executada na partição pai Hyper-V. Esta função retorna uma estrutura NDIS_HYPERVISOR_INFO que define o tipo de partição. Se o tipo de partição for relatado como NdisHypervisorPartitionMsHvParent, o miniport driver é executado na partição-mãe Hyper-V que está ligada ao PF no adaptador.
Observação Se o tipo de partição for relatado como NdisHypervisorPartitionMsHvChild, o driver de miniporta está sendo executado na partição filho Hyper-V que está conectada a um VF no adaptador. Nesse caso, o driver de miniporta não deve ser inicializado como um driver PF. Se possível, o driver deve ser inicializado como um driver VF, conforme descrito em Inicializando um driver de miniporta VF.
O driver de miniporta PF deve ler as palavras-chave padronizadas SR-IOV para determinar se SR-IOV está ativado e obter as definições de configuração do switch NIC. Para obter mais informações sobre essas palavras-chave, consulte Palavras-chave INF padronizadas para SR-IOV.
Observação Se o driver de miniporta PF registou um ponto de entrada para uma função MiniportSetOptions, o driver pode ter obtido anteriormente essas configurações do registo quando o NDIS chamou MiniportSetOptions.
Se o adaptador de rede suportar SR-IOV, fila de máquina virtual (VMQ) ou RSS, o driver de miniporta deve determinar qual recurso habilitar no adaptador de rede. Para obter mais informações sobre como determinar isso, consulte Manipulando palavras-chave INF padronizadas SR-IOV, VMQ e RSS.
Além das capacidades de hardware RSS e VMQ (se suportadas), o driver de miniporta deve informar as capacidades completas de hardware SR-IOV. Esses recursos devem ser anunciados independentemente das configurações de palavra-chave padronizadas SR-IOV no registro.
Se SR-IOV estiver habilitado no adaptador de rede, o driver de miniporta também deverá relatar as configurações de SR-IOV habilitadas atualmente no adaptador.
Para obter mais informações sobre como relatar as capacidades de SR-IOV, consulte Determinação das Capacidades de SR-IOV.
O driver de miniporta deve relatar seu conjunto completo de recursos de switch NIC de hardware. Esses recursos devem ser anunciados independentemente das configurações de palavra-chave padronizadas SR-IOV no registro.
Se SR-IOV estiver habilitado no adaptador de rede, o driver de miniporta também deverá informar as configurações do comutador NIC atualmente habilitadas no adaptador.
Para obter mais informações sobre como relatar os recursos do comutador NIC, consulte Determinando os recursos do comutador NIC.
O driver de miniporta deve relatar seu conjunto completo de recursos de filtragem de recebimento de hardware. Esses recursos devem ser anunciados independentemente das configurações de palavra-chave padronizadas SR-IOV no registro.
Se SR-IOV estiver habilitado no adaptador de rede, o driver de miniporta também deverá relatar as configurações de filtragem de recebimento habilitadas atualmente no adaptador.
Para obter mais informações sobre como relatar os recursos de filtragem de recebimento, consulte Determinando recursos de filtragem de recebimento.
Se o driver de miniporta oferecer suporte à criação de comutador NIC estático, ele deverá fazer o seguinte no contexto da chamada para MiniportInitializeEx.
O driver configura o hardware do adaptador com base nas configurações de palavra-chave padronizadas do comutador NIC. Com base nessas configurações, o driver aloca os recursos de hardware e software necessários para o switch NIC.
O driver de miniporta chama NdisMEnableVirtualization para habilitar SR-IOV e definir o número de VFs no adaptador de rede. Esta função configura o SR-IOV Extended Capability no espaço de configuração PCI do adaptador. Se essa função retornar NDIS_STATUS_SUCCESS, SR-IOV será ativada e os VFs serão expostos pela interface PCIe.
Para obter mais informações, consulte Criação Estática de um Switch NIC.
Observação Se o driver de miniporta oferecer suporte à criação dinâmica de comutadores NIC, ele criará o switch e habilitará a virtualização ao processar uma solicitação de método de identificador de objeto (OID) de OID_NIC_SWITCH_CREATE_SWITCH. Para obter mais informações, consulte criação dinâmica de um switch NIC.