Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Uma extensão de switch extensível Hyper-V emite uma solicitação de consulta de identificador de objeto (OID) de OID_SWITCH_PORT_ARRAY para obter uma matriz. Cada elemento na matriz especifica os parâmetros de configuração para uma porta de switch 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. Este buffer contém os seguintes dados:
Uma estrutura NDIS_SWITCH_PORT_ARRAY que define o número de elementos dentro da matriz.
Uma série de estruturas NDIS_SWITCH_PORT_PARAMETERS. Cada uma dessas estruturas contém informações sobre uma porta no switch extensível.
Observação Se nenhuma porta tiver sido criada no switch extensível, o driver definirá o NumElements membro da estrutura NDIS_SWITCH_PORT_ARRAY como zero e nenhuma NDIS_SWITCH_PORT_PARAMETERS estruturas serão retornadas.
Comentários
O OID_SWITCH_PORT_ARRAY OID 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 manipula a estrutura de NDIS_SWITCH_PORT_PARAMETERS retornada, ela não deve assumir que os vários membros da cadeia de caracteres da estrutura NDIS_SWITCH_PORT_PARAMETERS, como PortName, são terminados em nulo. Os tipos de dados para esses 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 a partir do valor do Length membro dessa estrutura.
Observação Se a cadeia de caracteres for terminada em nulo, o Length membro não deverá incluir o caractere nulo de terminação.
Códigos de status de retorno
A borda de miniporta subjacente do switch extensível conclui a solicitação de consulta OID de OID_SWITCH_PORT_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_PORT_ARRAY e sua matriz de elementos NDIS_SWITCH_PORT_PARAMETERS. A borda de miniporta subjacente do switch extensível define o DATA. 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. |
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |
Ver também
Consultando o de configuração do comutador extensível Hyper-V