OID_SWITCH_NIC_DELETE

A borda de protocolo do switch extensível Hyper-V emite uma solicitação de conjunto de identificador de objeto (OID) de OID_SWITCH_NIC_DELETE para a pilha de driver de switch extensível. Esta solicitação OID notifica as extensões de switch extensíveis subjacentes sobre a exclusão de uma conexão entre uma porta de switch extensível e um adaptador de rede. A borda do protocolo do switch extensível notificou anteriormente as extensões de que essa conexão está sendo excluída quando emitiu uma solicitação de conjunto OID de OID_SWITCH_NIC_DISCONNECT.

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

Comentários

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

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

Antes que a borda do protocolo do switch extensível emita a solicitação OID_SWITCH_NIC_DELETE, ela garante que todas as solicitações pendentes de envio ou recebimento de pacotes para a conexão do adaptador de rede especificada foram concluídas. A borda do protocolo também garante que todas as solicitações OID pendentes para a conexão do adaptador foram concluídas e os contadores de referência de switch extensíveis para a conexão do adaptador têm um valor zero.

Observação Se a extensão tiver incrementado um contador de referência de switch extensível para o adaptador de rede chamando ReferenceSwitchNic, a solicitação de OID_SWITCH_NIC_DELETE não será emitida enquanto o contador de referência for diferente de zero. A extensão diminui o contador de referência de switch extensível chamando DereferenceSwitchNic.

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

• A extensão não deve modificar a estrutura NDIS_SWITCH_NIC_PARAMETERS que está associada à solicitação OID.

• A extensão deve sempre encaminhar essa solicitação de conjunto OID para as extensões subjacentes. A prorrogação não deve completar o pedido.

• A extensão não deve emitir suas próprias solicitações de conjunto OID de OID_SWITCH_NIC_DELETE.

• O adaptador de rede externo do switch extensível pode se ligar a um ou mais adaptadores físicos subjacentes. Para cada adaptador de rede físico que está vinculado ao adaptador de rede externo, a borda de protocolo do switch extensível emite uma solicitação de conjunto OID separada de OID_SWITCH_NIC_DELETE. Cada solicitação de conjunto OID especifica um valor de índice de conexão de adaptador de rede diferente. Para obter mais informações sobre esses valores de índice, consulte Network Adapter Index Values.

  A extensão deve manter o estado de conexão para cada adaptador físico subjacente. Para obter mais informações sobre as diferentes configurações nas quais os adaptadores de rede física podem ser vinculados ao adaptador de rede externo, consulte tipos de configurações de adaptador de rede física.

Para obter mais informações sobre os estados das portas de switch extensíveis e conexões de adaptador de rede, consulte Hyper-V Extensible Switch Port and Network Adapter States.

Códigos de status de retorno

A borda de miniporta subjacente do switch extensível conclui a solicitação de consulta OID do OID_SWITCH_NIC_DELETE e retorna o seguinte código de status.

Requerimentos

Ver também

DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic