OID_NIC_SWITCH_VPORT_PARAMETERS

Artigo
06/15/2023

Um driver de sobreposição pode obter os parâmetros de uma porta virtual (VPort) em um comutador NIC que foi criado em um adaptador de rede que dá suporte à virtualização de E/S 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.

Drivers sobrepostos emitem uma solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS para definir os parâmetros de configuração de um VPort especificado anexado ao comutador NIC do adaptador de rede. Essas solicitações de conjunto de OID são emitidas para o driver de miniporte da PF (Função Física) PCI Express (PCIe) do adaptador de rede. Essas solicitações de conjunto de OID são necessárias para drivers de miniporto PF que dão suporte à interface sr-IOV (virtualização de E/S) raiz única.

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

O driver sobreposto especifica o VPort para o método OID ou a solicitação de definição definindo o membro VPortId da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS para 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.

Comentários

OID_NIC_SWITCH_VPORT_PARAMETERS pode ser usado em solicitações de método OID ou solicitações de conjunto de OID.

Tratamento de solicitações de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Drivers sobrepostos emitem uma solicitação de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para consultar os parâmetros de configuração atuais de um VPort anexado ao comutador NIC do adaptador de rede. Drivers sobrepostos especificam o VPort a ser consultado definindo o membro VPortId da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS para o identificador VPort.

O NDIS manipula a solicitação de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para drivers de miniport. O NDIS retorna informações obtidas de solicitações OID anteriores de OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_ENUM_VPORTS.

Após um retorno bem-sucedido da 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 de configuração para a opção especificada.

Para obter mais informações, consulte Consultando os parâmetros de uma porta virtual.

Manipulando solicitações de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Drivers sobrepostos emitem uma solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS para alterar os parâmetros de configuração atuais de um VPort anexado ao comutador NIC de um adaptador de rede. Essa solicitação OID pode ser usada para atualizar os parâmetros para o padrão, bem como VPorts não padrão.

Somente um subconjunto limitado de parâmetros de configuração para um VPort pode ser alterado. O driver sobressoante especifica o parâmetro a ser alterado definindo os seguintes membros da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS :

O membro VPortId é definido como o identificador do VPort cujos parâmetros serão alterados.
Os sinalizadores NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED apropriados são definidos no membro Flags . Os membros da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS só poderão ser alterados se um sinalizador NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED correspondente for definido em Ntddndis.h.
Os membros correspondentes da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS são definidos com os parâmetros de configuração do VPort que devem ser alterados.

Depois que o driver de miniporto PF recebe a solicitação de conjunto de OID de OID_NIC_SWITCH_VPORT_PARAMETERS, o driver configura o hardware com os parâmetros de configuração. O driver só pode alterar esses parâmetros de configuração identificados por sinalizadores NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED no membro Flags da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Para obter mais informações, consulte Definindo os parâmetros de uma porta virtual.

Retornar códigos de status

O driver de miniporto NDIS ou PF retorna o código status a seguir para solicitações OID definidas ou de método de OID_NIC_SWITCH_VPORT_PARAMETERS.

Código de status	Descrição
NDIS_STATUS_SUCCESS	A solicitação foi concluída com êxito. O InformationBuffer aponta para uma estrutura NDIS_NIC_SWITCH_CAPABILITIES .
NDIS_STATUS_NOT_SUPPORTED	O driver de miniporto PF não dá suporte à interface sr-IOV (virtualização de E/S raiz) ou não está habilitado para usar a interface.
NDIS_STATUS_INVALID_PARAMETER	Um ou mais dos membros da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS têm valores inválidos.
NDIS_STATUS_INVALID_LENGTH	O buffer de informações era muito curto. O NDIS ou o driver de miniporto PF define os DADOS. METHOD_INFORMATION. Membro BytesNeeded (para solicitações de método OID) ou DATA. SET_INFORMATION. Membro BytesNeeded (para solicitações de conjunto de OID) na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_FAILURE	A solicitação falhou por outros motivos.