Consultar a configuração do Comutador Extensível Hyper-V

A interface de comutador extensível do Hyper-V inclui solicitações de identificador de objeto (OID) emitidas por uma extensão de comutador extensível para consultar a configuração atual do comutador extensível, suas portas e suas conexões de adaptador de rede. Essas solicitações incluem os seguintes OIDs:

OID_SWITCH_NIC_ARRAY
Essa solicitação de consulta OID retorna uma matriz. Cada elemento na matriz especifica os parâmetros de configuração de um adaptador de rede associado a uma porta de comutador extensível.

OID_SWITCH_PARAMETERS
Essa solicitação de consulta OID retorna a configuração atual do comutador extensível.

OID_SWITCH_PORT_ARRAY
Essa solicitação de consulta OID retorna uma matriz. Cada elemento na matriz especifica os parâmetros de configuração para uma porta de comutador extensível.

OID_SWITCH_PORT_PROPERTY_ENUM
Essa solicitação de método OID retorna uma matriz. Cada elemento na matriz especifica as propriedades de uma política para uma porta de comutador extensível especificada.

OID_SWITCH_PROPERTY_ENUM
Essa solicitação de método OID retorna uma matriz. Cada elemento na matriz especifica as propriedades de uma política de comutador extensível.

Observação Quando uma extensão de comutador é associada a um Comutador Extensível do Hyper-V, ela deve primeiro emitir o OID OID_SWITCH_PARAMETERS para obter as informações básicas do comutador. Se o membro IsActive da estrutura NDIS_SWITCH_PARAMETERS for FALSE, a extensão não deverá emitir os outros OIDs de consulta até que a opção tenha concluído a ativação. Nesse caso, a notificação de NET_PNP_EVENT NetEventSwitchActivate especifica o evento de ativação do switch. Se o membro IsActive for TRUE na associação, a extensão poderá emitir com segurança os outros OIDs de consulta. Consultar a configuração enquanto o Comutador Extensível do Hyper-V não concluiu a ativação resultará na extensão com uma exibição inicial incompleta da configuração do comutador.

Observação Quando uma extensão gera suas próprias solicitações OID, ela faz isso da mesma maneira que qualquer driver de filtro NDIS. Para obter mais informações sobre como isso é feito, consulte Gerando solicitações OID de um driver de filtro NDIS.

Para obter mais informações sobre o caminho de controle para solicitações OID de comutador extensível, consulte Caminho de controle de comutador extensível do Hyper-V para solicitações OID.