OID_NIC_SWITCH_PARAMETERS
Um driver sobreposto emite uma solicitação de método OID (identificador de objeto) de OID_NIC_SWITCH_PARAMETERS para obter os parâmetros de configuração atuais de um comutador NIC especificado em um adaptador de rede. O NDIS manipula essas solicitações de método OID para o driver de miniporto.
Drivers sobrepostos emitem uma solicitação de conjunto OID de OID_NIC_SWITCH_PARAMETERS para definir os parâmetros de configuração de um comutador NIC especificado em um 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_PARAMETERS.
O driver sobreposto especifica a opção NIC para o método OID ou definir a solicitação definindo o SwitchId membro da estrutura NDIS_NIC_SWITCH_PARAMETERS para o identificador de comutador. O driver em excesso obtém o identificador de comutador por meio de uma das seguintes maneiras:
De uma solicitação de método OID anterior de OID_NIC_SWITCH_ENUM_SWITCHES.
Do NicSwitchArray membro da estrutura NDIS_BIND_PARAMETERS. O NDIS passa um ponteiro para essa estrutura no parâmetro BindParameters da funçãoProtocolBindAdapterEx.
No nicSwitchArray membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS. O NDIS passa um ponteiro para essa estrutura no parâmetro AttachParameters da funçãoFilterAttach.
Observação Começando com o Windows Server 2012, o Windows dá suporte apenas ao comutador NIC padrão no adaptador de rede. O membro SwitchId da estrutura de NDIS_NIC_SWITCH_PARAMETERS deve ser definido como NDIS_DEFAULT_SWITCH_ID.
Observações
Os problemas de driver excessivamente OID_NIC_SWITCH_PARAMETERS solicitações da seguinte maneira:
O driver sobreposto emite uma solicitação de método OID de OID_NIC_SWITCH_PARAMETERS para obter os parâmetros atuais de um comutador NIC especificado. Para obter mais informações, consulte Consultando os parâmetros de umade comutador NIC.
Observação NDIS manipula solicitações de método OID de OID_NIC_SWITCH_PARAMETERS para o driver de miniporto PF.
O driver sobreposto emite uma solicitação de conjunto de OID de OID_NIC_SWITCH_PARAMETERS para alterar os parâmetros atuais de um comutador NIC especificado. Para obter mais informações, consulte Definindo os parâmetros de um comutador NIC.
Observação o driver de miniporto PF manipula solicitações de conjunto de OID de OID_NIC_SWITCH_PARAMETERS.
Códigos de status de retorno
O driver de miniporto NDIS ou PF retorna os seguintes códigos de status para solicitações OID definidas ou de método de OID_NIC_SWITCH_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_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_REINIT_REQUIRED |
O driver de miniporto PF requer uma reinicialização do adaptador de rede para aplicar as alterações ao comutador NIC. |
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) |