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 ou aplicativo de modo de usuário excessiva emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_ENUM_VPORTS para obter uma matriz. Cada elemento na matriz especifica os atributos de uma porta virtual (VPort) que foi criada no comutador NIC de um adaptador de rede.
Após um retorno bem-sucedido dessa solicitação de consulta OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer que contém o seguinte:
Uma estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY que define o número de elementos dentro da matriz.
Uma matriz de estruturas NDIS_NIC_SWITCH_VPORT_INFO. Cada uma dessas estruturas contém informações sobre um VPort no comutador NIC do adaptador de rede.
Observação Se nenhum VPorts tiver sido criado no adaptador de rede, o driver definirá o NumElements membro da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY como zero e nenhuma estrutura de NDIS_NIC_SWITCH_VPORT_INFO será retornada.
Observações
Drivers sobrepostos e aplicativos de modo de usuário emitem solicitações de consulta OID de OID_NIC_SWITCH_ENUM_VPORTS para enumerar os VPorts alocados no comutador NIC de um adaptador de rede.
Antes que o driver ou aplicativo emita a solicitação OID, ele deve inicializar uma estrutura de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY que é passada junto com a solicitação. O driver ou aplicativo deve seguir estas diretrizes ao inicializar a estrutura de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY:
Se o sinalizador de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH estiver definido no membro sinalizadores do, as informações serão retornadas para todos os VPorts criados em um comutador NIC especificado. A opção NIC é especificada pelo SwitchId membro dessa estrutura.
Observação Começando com o Windows Server 2012, a interface SR-IOV dá suporte apenas ao comutador NIC padrão no adaptador de rede. Independentemente dos sinalizadores que estão definidos no membro sinalizadores do, o membro switchid do deve ser definido como NDIS_DEFAULT_SWITCH_ID.
Se o sinalizador de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION estiver definido no membro Flags, as informações serão retornadas para todos os VPorts anexados a uma função física PCI Express (PCIe) especificada (PF) ou VF (Função Virtual) no adaptador de rede. O PF ou VF é especificado pelo membro AttachedFunctionId dessa estrutura.
Se o membro AttachedFunctionId estiver definido como NDIS_PF_FUNCTION_ID, as informações serão retornadas para todos os VPorts, incluindo o VPort padrão, que são anexados ao PF do adaptador de rede. Se o membro AttachedFunctionId for definido como um identificador VF válido, as informações serão retornadas para todos os VPorts para o VF especificado.
Observação Começando com o Windows Server 2012, apenas um VPort não padrão pode ser anexado a um VF. No entanto, vários VPorts (incluindo o VPort padrão) podem ser anexados ao PF.
Se o Flags membro estiver definido como zero, as informações serão retornadas para todos os VPorts anexados ao PF ou VF no adaptador de rede. Nesse caso, os valores do SwitchId e AttachedFunctionId são ignorados.
Para obter mais informações, consulte Enumerando portas virtuais em um adaptador de rede.
Códigos de status de retorno
O NDIS manipula a solicitação do método OID da solicitação OID_NIC_SWITCH_ENUM_VPORTS para drivers de miniporto. Os drivers não serão emitidos nesta solicitação OID.
Quando o NDIS manipula a solicitação de OID_NIC_SWITCH_ENUM_VPORTS, ele retorna um dos seguintes códigos de status:
| 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 não dá suporte à interface de virtualização de E/S raiz única (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_VF_INFO_ARRAY têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O buffer de informações era muito curto. O NDIS define os dados de . 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) |