Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um driver sobreposto emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_CREATE_VPORT para criar uma VPort (porta virtual não padrão) no comutador NIC de um adaptador de rede. Essa solicitação de método OID também anexa o VPort criado à função física PCI Express (PCIe) do adaptador de rede (PF) ou a uma VF (Função Virtual PCIe) alocada anteriormente.
Drivers em excesso emitem essa solicitação de método OID para o driver de miniporto para o PF do adaptador de rede. 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).
O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para a estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS.
Observações
O driver em excesso inicializa a estrutura de NDIS_NIC_SWITCH_VPORT_PARAMETERS com as informações de configuração sobre o VPort não padrão a ser criado. As informações de configuração incluem a função PCIe à qual o VPort não padrão está anexado e o número de pares de fila para o VPort não padrão.
Quando o driver de miniporto PF é emitido a solicitação OID, o driver aloca os recursos de hardware e software associados ao VPort não padrão especificado. Depois que todos os recursos forem alocados com êxito, o driver de miniporto PF concluirá a OID com êxito retornando NDIS_STATUS_SUCCESS de miniportOidRequest.
Se a solicitação OID_NIC_SWITCH_CREATE_VPORT for concluída com êxito, o driver de miniporto PF e o driver sobreposto deverão manter o VPortId valor do VPort não padrão para operações sucessivas. O valor VPortId é usado durante estas operações:
O NDIS e os drivers sobrepostos usam o valor VPortId para identificar o VPort não padrão em solicitações OID sucessivas relacionadas a este VPort, como OID_NIC_SWITCH_VPORT_PARAMETERS e OID_NIC_SWITCH_DELETE_VPORT.
Durante as operações de envio, o NDIS especifica o valor VPortId para identificar o VPort do qual um pacote foi enviado. Esse valor é especificado no OOB (fora de banda) NDIS_NET_BUFFER_LIST_FILTERING_INFO dados da estrutura NET_BUFFER_LIST.
Durante as operações de recebimento, o driver de miniporto PF especifica o VPortId valor para o qual um pacote deve ser encaminhado. Esse valor também é especificado nos dados de NDIS_NET_BUFFER_LIST_FILTERING_INFO OOB da estrutura de NET_BUFFER_LIST.
Para obter mais informações, consulte Criando uma porta virtual.
Observação O VPort padrão sempre existe e não é criado por uma solicitação OID de OID_NIC_SWITCH_CREATE_VPORT. O VPort padrão tem um identificador de NDIS_DEFAULT_VPORT_ID. Quando o driver de miniporto PF cria um comutador NIC, o driver anexa automaticamente o VPort padrão ao PF do adaptador de rede.
Códigos de status de retorno
O driver de miniporto NDIS ou 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_VPORT_PARAMETERS têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_VPORT_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) |