OID_SWITCH_PORT_ARRAY

Uma extensão de comutador extensível do Hyper-V emite uma solicitação de consulta OID (identificador de objeto) de OID_SWITCH_PORT_ARRAY para obter uma matriz. Cada elemento na matriz especifica os parâmetros de configuração para uma porta de comutador extensível.

Se a solicitação de consulta OID for concluída com êxito, o membro InformationBuffer da estrutura NDIS_OID_REQUEST conterá um ponteiro para um buffer. Esse buffer contém os seguintes dados:

• Uma estrutura NDIS_SWITCH_PORT_ARRAY que define o número de elementos dentro da matriz.

• Uma matriz de estruturas de NDIS_SWITCH_PORT_PARAMETERS . Cada uma dessas estruturas contém informações sobre uma porta no comutador extensível.

  Nota Se nenhuma porta tiver sido criada no comutador extensível, o driver definirá o membro NumElements da estrutura NDIS_SWITCH_PORT_ARRAY como zero e nenhuma estrutura de NDIS_SWITCH_PORT_PARAMETERS será retornada.

Comentários

O OID_SWITCH_PORT_ARRAY OID só deve ser emitido quando a opção extensível do Hyper-V tiver concluído a ativação. Consulte Consultando a Configuração do Comutador Extensível do Hyper-V para obter mais detalhes.

Quando a extensão manipula a estrutura de NDIS_SWITCH_PORT_PARAMETERS retornada, não deve presumir que os vários membros de cadeia de caracteres da estrutura NDIS_SWITCH_PORT_PARAMETERS , como PortName, sejam encerrados em nulo. Os tipos de dados para esses membros de cadeia de caracteres são definidos pelo tipo pela estrutura IF_COUNTED_STRING . O driver deve determinar o comprimento da cadeia de caracteres do valor do membro Length dessa estrutura.

Nota Se a cadeia de caracteres for terminada em nulo, o membro Length não deverá incluir o caractere nulo de terminação.

Retornar códigos de status

A borda do miniporto subjacente do comutador 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 do miniporto subjacente do comutador extensível define o DATA. 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.
parâmetro	Ntddndis.h (inclua Ndis.h)

Confira também

---

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

Consultando a configuração de comutador extensível do Hyper-V