Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um driver em excesso 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 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 miniporto da função física PCI Express (PCIe) do adaptador de rede (PF). Essas solicitações de conjunto de OID são necessárias para drivers de miniporto PF que dão suporte à interface de virtualização de E/S raiz única (SR-IOV).
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 definir a solicitação definindo o VPortId membro da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS para o identificador associado ao VPort. O driver em excesso obtém o identificador VPort por meio de uma das seguintes maneiras:
A partir de uma solicitação de método OID anterior de OID_NIC_SWITCH_CREATE_VPORT.
A partir de uma solicitação de método OID anterior de OID_NIC_SWITCH_ENUM_VPORTS.
Observações
OID_NIC_SWITCH_VPORT_PARAMETERS pode ser usado em solicitações de método OID ou solicitações de conjunto de OID.
tratando solicitações de método OID de OID_NIC_SWITCH_VPORT_PARAMETERS
Drivers em excesso 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 para consultar definindo o VPortId membro 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 miniporto. 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 comutador especificado.
Para obter mais informações, consulte Consultando os parâmetros de uma porta virtual.
tratando 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 de NDIS_NIC_SWITCH_VPORT_PARAMETERS:
O membro VPortId é definido como o identificador do VPort cujos parâmetros serão alterados.
Os sinalizadores de_CHANGED xxx NDIS_NIC_SWITCH_VPORT_PARAMETERS_apropriados são definidos no membro sinalizadores. Os membros da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS só poderão ser alterados se um sinalizador de NDIS_NIC_SWITCH_PARAMETERS_xxx_CHANGED correspondente for definido em Ntddndis.h.
Os membros correspondentes da estrutura de 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 NDIS_NIC_SWITCH_VPORT_PARAMETERS_sinalizadores xxx_CHANGED no membro sinalizadores 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
O driver de miniporto NDIS ou PF retorna o código de 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 de virtualização de E/S 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. O NDIS ou o driver de miniporto PF define o DATA. METHOD_INFORMATION. Membro bytesNeeded (para solicitações de método OID) ou DATA. SET_INFORMATION. BytesNeededed membro (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. |
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |