OID_NIC_SWITCH_VPORT_PARAMETERS

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

Os drivers sobrepostos emitem uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS para definir os parâmetros de configuração de um VPort especificado que está conectado ao switch NIC do adaptador de rede. Essas solicitações de conjunto OID são emitidas para o driver de miniporta da função física (PF) PCI Express (PCIe) do adaptador de rede. Essas solicitações de conjunto OID são necessárias para drivers de miniporta PF que suportam a interface de virtualização de E/S de raiz única (SR-IOV).

O InformationBuffer membro 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 set definindo o VPortId membro da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS para o identificador associado ao VPort. O driver sobrejacente obtém o identificador VPort através 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 OID.

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

Os 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 que está conectado ao switch NIC do adaptador de rede. Os drivers sobrepostos especificam o VPort a ser consultado definindo o VPortId membro da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS para o identificador VPort.

O NDIS lida com a solicitação do método OID de OID_NIC_SWITCH_VPORT_PARAMETERS para drivers de miniporta. 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 do método OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS. Essa estrutura contém os parâmetros de configuração para o switch especificado.

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

Tratamento de solicitações de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS

Os drivers sobrepostos emitem uma solicitação de conjunto OID de OID_NIC_SWITCH_VPORT_PARAMETERS para alterar os parâmetros de configuração atuais de um VPort que está conectado ao switch NIC de um adaptador de rede. Esta solicitação OID pode ser usada para atualizar os parâmetros para VPorts padrão e não padrão.

Apenas um subconjunto limitado de parâmetros de configuração para um VPort pode ser alterado. O driver sobreposto 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.
As bandeiras_CHANGED NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx apropriadas são definidas no Flags membro. Os membros da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS só podem ser alterados se um sinalizador de_CHANGED NDIS_NIC_SWITCH_PARAMETERS_Xxx 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 VPort que devem ser alterados.

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

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

Códigos de status de retorno

NDIS ou o driver de miniporta PF retorna o seguinte código de status para solicitações OID de conjunto ou 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 miniporta PF não suporta a interface de virtualização de E/S de raiz única (SR-IOV) 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. NDIS ou o driver de miniporta PF define o DATA. METHOD_INFORMATION. BytesNeeded membro (para solicitações de método OID) ou DATA. SET_INFORMATION. BytesNeeded membro (para solicitações de conjunto OID) na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.