OID_NIC_SWITCH_ENUM_VPORTS

Um driver sobreposto ou aplicativo de modo de usuário emite uma solicitação de método de identificador de objeto (OID) 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 switch 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 NDIS_NIC_SWITCH_VPORT_INFO estruturas. Cada uma dessas estruturas contém informações sobre um VPort no switch NIC do adaptador de rede.

Observação Se nenhum VPorts tiver sido criado no adaptador de rede, o driver define o NumElements membro da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY como zero e nenhuma estrutura NDIS_NIC_SWITCH_VPORT_INFO será retornada.

Comentários

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 switch NIC de um adaptador de rede.

Antes que o driver ou aplicativo emita a solicitação OID, ele deve inicializar uma estrutura 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 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY:

Se o sinalizador de NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH estiver definido no membro Flags, as informações serão retornadas para todos os VPorts criados em um switch NIC especificado. O comutador NIC é especificado pelo SwitchId membro dessa estrutura.

Observação A partir do Windows Server 2012, a interface SR-IOV suporta apenas o comutador NIC padrão no adaptador de rede. Independentemente dos sinalizadores definidos no membro Flags, o membro SwitchId deve ser definido como NDIS_DEFAULT_SWITCH_ID.
Se o sinalizador 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 conectados a uma função física (PF) ou função virtual (VF) PCI Express (PCIe) especificada no adaptador de rede. O PF ou VF é especificado pelo AttachedFunctionId membro 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 estão conectados ao PF do adaptador de rede. Se o membro AttachedFunctionId estiver definido como um identificador VF válido, as informações serão retornadas para todos os VPorts para o VF especificado.

Observação A partir do 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 membro Flags estiver definido como zero, as informações serão retornadas para todos os VPorts conectados 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 lida com a solicitação do método OID da solicitação de OID_NIC_SWITCH_ENUM_VPORTS para drivers de miniporta. Os drivers não serão emitidos esta solicitação OID.

Quando o NDIS lida com 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 miniporta não suporta a interface de virtualização de E/S de 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. METHOD_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.