OID_NIC_SWITCH_ENUM_SWITCHES

Um driver sobreposto ou aplicativo de modo de usuário emite uma solicitação de consulta de identificador de objeto (OID) 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 InformationBuffer membro 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 série de NDIS_NIC_SWITCH_INFO estruturas. Cada uma dessas estruturas contém as informações sobre um único comutador NIC criado no adaptador de rede.

Observação Se o adaptador de rede não tiver comutadores NIC, o driver define o NumElements membro da estrutura de NDIS_NIC_SWITCH_INFO_ARRAY como zero e nenhuma estrutura NDIS_NIC_SWITCH_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_SWITCHES para enumerar os comutadores NIC criados em um adaptador de rede.

Observação A partir do Windows Server 2012, a interface de virtualização de E/S de raiz única (SR-IOV) suporta apenas o 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 switch NIC padrão, que é referenciado pelo identificador de NDIS_DEFAULT_SWITCH_ID.

Códigos de status de retorno

O NDIS lida com a solicitação de consulta OID da solicitação de OID_NIC_SWITCH_ENUM_SWITCHES 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_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 miniporta não suporta a 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. 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.