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.
Uma extensão de comutador extensível Hyper-V emite uma solicitação de consulta OID (identificador de objeto) de OID_SWITCH_NIC_ARRAY para obter uma matriz. Cada elemento na matriz especifica os parâmetros de configuração de um adaptador de rede virtual associado a uma porta de comutador extensível.
Se a solicitação de consulta OID for concluída com êxito, o InformationBuffer membro da estrutura NDIS_OID_REQUEST conterá um ponteiro para um buffer. Esse buffer contém os seguintes dados:
Uma estrutura NDIS_SWITCH_NIC_ARRAY que define o número de elementos na matriz. Essa estrutura também especifica o deslocamento para o primeiro elemento na matriz.
Uma matriz de estruturas NDIS_SWITCH_NIC_PARAMETERS. Cada uma dessas estruturas contém informações sobre um adaptador de rede conectado a uma porta de comutador extensível.
Observação Se nenhum adaptador de rede estiver conectado a portas de comutador extensíveis, a borda do miniporto subjacente do comutador extensível definirá o NumElements membro da estrutura NDIS_SWITCH_NIC_ARRAY como zero. Nesse caso, nenhuma estrutura de NDIS_SWITCH_NIC_PARAMETERS é retornada.
Observações
O OID OID_SWITCH_NIC_ARRAY só deve ser emitido quando o comutador extensível Hyper-V tiver concluído a ativação. Consulte Consultando o de Configuração do Comutador Extensível Hyper-V para obter mais detalhes.
Quando a extensão processa a estrutura de NDIS_SWITCH_NIC_PARAMETERS retornada, não deve presumir que os vários membros da cadeia de caracteres da estrutura NDIS_SWITCH_PORT_PARAMETERS, como NicFriendlyName, sejam encerrados em NULL. Os tipos de dados desses membros de cadeia de caracteres são definidos por tipo pela estrutura IF_COUNTED_STRING. O driver deve determinar o comprimento da cadeia de caracteres do valor do Length membro dessa estrutura.
Observação Se a cadeia de caracteres for terminada em nulo, o membro comprimento não deverá incluir o caractere nulo de encerramento.
Códigos de status de retorno
A borda do miniporto subjacente do comutador extensível conclui a solicitação de consulta OID de OID_SWITCH_NIC_ARRAY e 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_INVALID_LENGTH |
O comprimento do buffer de informações é muito pequeno para retornar o NDIS_SWITCH_NIC_ARRAY e sua matriz de elementos NDIS_SWITCH_NIC_PARAMETERS. A borda do miniporto subjacente do comutador extensível define a DATA. QUERY_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) |
Consulte também
consultando o de configuração do comutador extensível Hyper-V