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 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) que são anexados 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 InformationBuffer membro 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.
Observação Se nenhum VF estiver anexado a um comutador NIC no adaptador de rede, o NumElements membro da estrutura NDIS_NIC_SWITCH_VF_INFO_ARRAY será definido como zero e nenhuma estrutura de NDIS_NIC_SWITCH_VF_INFO será retornada.
Observações
Drivers sobrepostos e aplicativos de modo de usuário emitem solicitações de método OID de OID_NIC_SWITCH_ENUM_VFS para enumerar os VFs anexados ao 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_VF_INFO_ARRAY que é passada junto com a solicitação. O driver ou o aplicativo deve seguir estas diretrizes ao inicializar a estrutura de NDIS_NIC_SWITCH_VF_INFO_ARRAY:
Se o sinalizador de NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH estiver definido no membro sinalizadores do, o driver ou aplicativo deverá definir o membro SwitchId para 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 apenas para o comutador NIC especificado no adaptador de rede SR-IOV.
Observação 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 Flags membro estiver definido como zero, o driver ou aplicativo deverá definir o membro do switchId como zero. Ao definir esses membros dessa forma, as informações de VF são retornadas para toda a opção NIC no adaptador de rede SR-IOV.
Observação Começando com o Windows Server 2012, o Windows dá suporte apenas ao comutador NIC padrão no adaptador de rede. Independentemente dos sinalizadores definidos no membro sinalizadores do, o membro do switchId do deve ser definido como NDIS_DEFAULT_SWITCH_ID.
Para obter mais informações sobre as opções nic, consulte comutadores NIC.
Códigos de status de retorno
O NDIS manipula a solicitação do método OID da solicitação OID_NIC_SWITCH_ENUM_VFS 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_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 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) |