OID_NIC_SWITCH_ENUM_SWITCHES
Um driver sobreposto ou aplicativo de modo de usuário emite uma solicitação de consulta OID (identificador de objeto) de OID_NIC_SWITCH_ENUM_SWITCHES para obter uma matriz. Cada elemento na matriz especifica os atributos de um comutador NIC que foi criado em 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_INFO_ARRAY que define o número de elementos dentro da matriz.
Uma matriz de estruturas de NDIS_NIC_SWITCH_INFO . Cada uma dessas estruturas contém as informações sobre um único comutador NIC criado no adaptador de rede.
Nota Se o adaptador de rede não tiver comutadores NIC, o driver definirá o membro NumElements da estrutura NDIS_NIC_SWITCH_INFO_ARRAY como zero e nenhuma estrutura NDIS_NIC_SWITCH_INFO será retornada.
Comentários
Drivers e aplicativos de modo de usuário emitem solicitações de consulta OID de OID_NIC_SWITCH_ENUM_SWITCHES para enumerar os comutadores NIC criados em um adaptador de rede.
Nota Começando com Windows Server 2012, a interface sr-IOV (virtualização de E/S raiz) só dá suporte ao comutador NIC padrão no adaptador de rede. Portanto, a estrutura de NDIS_NIC_SWITCH_INFO_ARRAY retornada deve especificar um único elemento NDIS_NIC_SWITCH_INFO para o comutador NIC padrão, que é referenciado pelo identificador de NDIS_DEFAULT_SWITCH_ID.
Retornar códigos de status
O NDIS manipula a solicitação de consulta OID da solicitação de OID_NIC_SWITCH_ENUM_SWITCHES para drivers de miniporte. Os drivers não serão emitidos nesta solicitação de OID.
Quando o NDIS manipula a solicitação de OID_NIC_SWITCH_ENUM_SWITCHES, 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 miniporte não dá suporte à interface 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_INFO_ARRAY têm valores inválidos. |
NDIS_STATUS_INVALID_LENGTH |
O buffer de informações era muito curto. O NDIS define os DADOS. QUERY_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. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |