OID_NIC_SWITCH_ENUM_VPORTS

Artigo
06/15/2023

Um driver ou aplicativo de modo de usuário 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 VPort (porta virtual) que foi criada no comutador NIC de um adaptador de rede.

Após um retorno bem-sucedido dessa solicitação de consulta OID, o membro InformationBuffer 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.

Nota Se nenhuma VPorts tiver sido criada no adaptador de rede, o driver definirá o membro NumElements da estrutura NDIS_NIC_SWITCH_VPORT_INFO_ARRAY como zero e nenhuma estrutura de NDIS_NIC_SWITCH_VPORT_INFO será retornada.

Comentários

Drivers e aplicativos de modo de usuário emitem solicitações de consulta OID de OID_NIC_SWITCH_ENUM_VPORTS para enumerar as VPorts alocadas no comutador 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 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH estiver definido no membro Flags , as informações serão retornadas para todas as VPorts criadas em uma opção NIC especificada. A opção NIC é especificada pelo membro SwitchId dessa estrutura.

Nota Começando com Windows Server 2012, a interface SR-IOV dá suporte apenas à opção 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 todas as VPorts anexadas a uma PF (Função Física) PCI Express (PCIe) especificada 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, anexados 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 todas as VPorts para o VF especificado.

Nota Começando com Windows Server 2012, apenas um VPort não padrão pode ser anexado a uma 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 todas as VPorts anexadas ao PF ou VF no adaptador de rede. Nesse caso, os valores de 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 de OID_NIC_SWITCH_ENUM_VPORTS para drivers de miniporta. Os drivers não serão emitidos nesta solicitação de OID.

Quando o NDIS manipula a solicitação 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 dá suporte à interface SR-IOV (virtualização de E/S de raiz única) 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. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_FAILURE	A solicitação falhou por outros motivos.