OID_NIC_SWITCH_ENUM_VFS

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_VFS para obter uma matriz. Cada elemento na matriz especifica os atributos de uma VF (Função Virtual) PCI Express (PCIe) anexada a um comutador NIC 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_VF_INFO_ARRAY que define o número de elementos dentro da matriz.
Uma matriz de estruturas NDIS_NIC_SWITCH_VF_INFO . Cada uma dessas estruturas contém informações sobre um único VF em um comutador NIC do adaptador de rede. Uma VF é anexada a uma opção NIC por meio de solicitações de método OID de OID_NIC_SWITCH_ALLOCATE_VF.

Nota Se nenhuma VF estiver anexada a um comutador NIC no adaptador de rede, o membro NumElements da estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY será definido como zero e nenhuma estrutura de NDIS_NIC_SWITCH_VF_INFO será retornada.

Comentários

Drivers e aplicativos de modo de usuário emitem solicitações de método OID de OID_NIC_SWITCH_ENUM_VFS para enumerar as VFs anexadas ao 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_VF_INFO_ARRAY que é passada junto com a solicitação. O driver ou aplicativo deve seguir estas diretrizes ao inicializar a estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY :

Se o sinalizador NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH estiver definido no membro Flags , o driver ou aplicativo deverá definir o membro SwitchId como o identificador de comutador NIC no adaptador de rede SR-IOV. Ao definir esses membros dessa forma, as informações de VF são retornadas somente para a opção NIC especificada no adaptador de rede SR-IOV.

Nota O driver sobreposto e o aplicativo de modo de usuário podem obter os identificadores de comutador NIC emitindo uma solicitação de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES.
Se o membro Flags estiver definido como zero, o driver ou aplicativo deverá definir o membro SwitchId como zero. Ao definir esses membros dessa maneira, as informações de VF são retornadas para toda a opção NIC no adaptador de rede SR-IOV.

Nota A partir do Windows Server 2012, o Windows dá suporte apenas ao 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.

Para obter mais informações sobre comutadores NIC, consulte Comutadores NIC.

Códigos de status de retorno

O NDIS manipula a solicitação de método OID da solicitação de OID_NIC_SWITCH_ENUM_VFS para drivers de miniporta. Os drivers não serão emitidos nesta solicitação de OID.

Quando o NDIS manipula a solicitação de OID_NIC_SWITCH_ENUM_VFS, 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.