Consultando os parâmetros de uma porta virtual

Um driver overlying pode obter os parâmetros de uma porta virtual (VPort) em um comutador NIC em um adaptador de rede que dá suporte à virtualização de E/S de raiz única (SR-IOV). O driver emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_VPORT_PARAMETERS para obter esses parâmetros.

Antes que o driver sobreposto emita essa solicitação de método OID, ele deve inicializar uma estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS . O driver deve definir os membros dessa estrutura da seguinte maneira:

• O membro SwitchId deve ser definido como o identificador da opção NIC para o qual os parâmetros devem ser retornados.

  Nota A partir do Windows Server 2012, a interface SR-IOV dá suporte a apenas uma opção NIC no adaptador de rede. Essa opção é conhecida como a opção NIC padrão. O membro SwitchId deve ser definido como NDIS_DEFAULT_SWITCH_ID.

• O membro VPortId deve ser definido como o identificador associado ao VPort. O driver overlying obtém o identificador VPort por meio de uma das seguintes maneiras:

  • De uma solicitação de método OID anterior de OID_NIC_SWITCH_CREATE_VPORT.

  • De uma solicitação de método OID anterior de OID_NIC_SWITCH_ENUM_VPORTS.

Após um retorno bem-sucedido dessa solicitação de método OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_NIC_SWITCH_VPORT_PARAMETERS . Essa estrutura contém os parâmetros para o VPort especificado.

O NDIS lida com a solicitação de OID_NIC_SWITCH_VPORT_PARAMETERS para drivers de miniporte. O NDIS retorna as informações de um cache interno dos dados que ele mantém ao inspecionar as seguintes fontes:

• Solicitações de método OID de OID_NIC_SWITCH_CREATE_VPORT.

• OID define solicitações de OID_NIC_SWITCH_VPORT_PARAMETERS.