OID_SWITCH_NIC_UPDATED

Artigo
06/15/2023

A borda do protocolo do comutador extensível do Hyper-V emite uma solicitação de conjunto de OID (identificador de objeto) de OID_SWITCH_NIC_UPDATED para a pilha do driver de comutador extensível. Essa solicitação OID notifica as extensíveis sobre a atualização dos parâmetros de um adaptador de rede. O OID só será emitido para NICs que já foram conectadas e ainda não iniciou o processo de desconexão. Essas alterações de configuração em tempo de execução podem incluir NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress e VFAssigned.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_SWITCH_NIC_PARAMETERS .

Comentários

O membro PortId da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica a porta para a qual a notificação de atualização está sendo feita. A extensão de comutador extensível pode obter as informações de parâmetro para essa e outras portas na opção extensível emitindo solicitações de consulta OID de OID_SWITCH_PORT_ARRAY.

O membro Index da estrutura NDIS_SWITCH_NIC_PARAMETERS especifica o índice de um adaptador de rede para o qual a notificação de atualização está sendo feita. O adaptador de rede com o valor de Índice especificado está conectado à porta de comutador extensível especificada pelo membro PortId . Para obter mais informações sobre esses valores de índice, consulte Valores de índice do adaptador de rede.

A extensão deve seguir estas diretrizes para lidar com solicitações de conjunto de OID de OID_SWITCH_NIC_UPDATED:

A extensão não deve modificar a estrutura NDIS_SWITCH_NIC_PARAMETERS associada à solicitação OID.
A extensão deve sempre encaminhar essa solicitação de conjunto de OID para extensões subjacentes. A extensão não deve concluir a solicitação.
A extensão não deve emitir suas próprias solicitações de conjunto de OID de OID_SWITCH_NIC_UPDATED.

Retornar códigos de status

A borda do miniporto subjacente do comutador extensível conclui a solicitação de consulta OID de OID_SWITCH_NIC_UPDATED e retorna o código status a seguir.