OID_NIC_SWITCH_CREATE_SWITCH
O NDIS emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_CREATE_SWITCH para criar um comutador NIC em um adaptador de rede. Quando ele lida com essa solicitação OID, o driver de miniporto aloca os recursos para a opção NIC no adaptador.
O NDIS emite essa solicitação de método OID para o driver de miniporto da função física PCI Express (PCIe) do adaptador de rede (PF). Essa solicitação de método OID é necessária para drivers de miniporto PF que dão suporte à interface de virtualização de E/S raiz única (SR-IOV).
Observação drivers sobrepostos, como drivers de protocolo ou filtro, não podem emitir solicitações de método OID de OID_NIC_SWITCH_CREATE_SWITCH para o driver de miniporto PF.
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_PARAMETERS.
Observações
Quando ele recebe a solicitação do método OID de OID_NIC_SWITCH_CREATE_SWITCH, o driver de miniporto PF deve fazer o seguinte:
Se o driver de miniporto PF der suporte à criação e à configuração do comutador estático, ele criará a opção NIC quando o NDIS chamar MiniportInitializeEx. Quando o driver manipula essa solicitação OID, ele deve verificar os parâmetros de configuração na estrutura NDIS_NIC_SWITCH_PARAMETERS. Os parâmetros devem ser os mesmos usados pelo driver para criar a opção durante a chamada para MiniportInitializeEx. Se isso não for verdade, o driver deverá falhar na solicitação de OID.
Para obter mais informações, consulte criação estática de umde comutador NIC.
Se o driver de miniporto PF der suporte à criação e à configuração do comutador dinâmico, o driver deverá validar os valores de configuração da estrutura de NDIS_NIC_SWITCH_PARAMETERS e criar o comutador NIC com base nesses valores.
Para obter mais informações, consulte Criação dinâmica de umde comutador NIC.
O driver de miniporto PF deve alocar os recursos de hardware e software necessários para o VPort padrão na opção NIC.
Observação O VPort padrão sempre é criado por meio de uma solicitação OID de OID_NIC_SWITCH_CREATE_SWITCH e excluído por meio de uma solicitação OID de OID_NIC_SWITCH_DELETE_SWITCH. Solicitações OID de OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_DELETE_VPORT são usadas para a criação e exclusão de VPorts não padrão na opção NIC.
O driver de miniporto PF que dá suporte à criação e à configuração do comutador dinâmico deve habilitar SR-IOV virtualização no comutador chamando NdisMEnableVirtualization. Essa chamada configura o membro NumVFs e o VF Enable bit na estrutura SR-IOV Capacidade Estendida do espaço de configuração do PCI Express (PCIe) do adaptador.
Para obter mais informações sobre o espaço de configuração SR-IOV, consulte a PCI-SIG especificação de virtualização de E/S de E/S de Raiz Única e Compartilhamento 1.1 especificação.
Observação Se o driver de miniporto PF der suporte à criação de comutador estático, ele habilitará SR-IOV virtualização depois de criar a opção quando MiniportInitializeEx for chamado.
Se o driver de miniporto PF concluir com êxito a solicitação do método OID de OID_NIC_SWITCH_CREATE_SWITCH, ele permitirá que o seguinte ocorra:
Os VFs podem ser alocados na opção NIC por meio de solicitações de método OID de OID_NIC_SWITCH_ALLOCATE_VF.
VPorts nondefault podem ser criados na opção NIC por meio de solicitações de método OID de OID_NIC_SWITCH_CREATE_VPORT.
Para obter mais informações sobre como lidar com essa solicitação OID, consulte Manipulando ode Solicitação de OID_NIC_SWITCH_CREATE_SWITCH.
Códigos de status de retorno
O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação de método OID de OID_NIC_SWITCH_CREATE_SWITCH.
Código de status | Descrição |
---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
NDIS_STATUS_NOT_SUPPORTED |
O driver de miniporto PF não dá suporte à interface SR-IOV ou não está habilitado para usar a interface. |
NDIS_STATUS_INVALID_PARAMETER |
Um ou mais dos membros da estrutura NDIS_NIC_SWITCH_PARAMETERS têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_PARAMETERS). O driver de miniporto PF deve definir o data . METHOD_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário. |
NDIS_STATUS_FAILURE |
A solicitação falhou por outros motivos. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |