OID_SWITCH_NIC_UPDATED
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.
| Código de status | Descrição |
|---|---|
NDIS_STATUS_SUCCESS |
A solicitação OID foi concluída com êxito. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |