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 miniport.
Drivers sobrepostos emitem uma solicitação de conjunto de 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 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_PARAMETERS .
O driver sobreposto especifica a opção NIC para o método OID ou definir a solicitação definindo o membro SwitchId da estrutura NDIS_NIC_SWITCH_PARAMETERS para o identificador de comutador. O driver overlying 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 membro NicSwitchArray da estrutura NDIS_BIND_PARAMETERS . O NDIS passa um ponteiro para essa estrutura no parâmetro BindParameters da função ProtocolBindAdapterEx .
Do membro NicSwitchArray da estrutura NDIS_FILTER_ATTACH_PARAMETERS . O NDIS passa um ponteiro para essa estrutura no parâmetro AttachParameters da função FilterAttach .
Nota Começando com Windows Server 2012, o Windows dá suporte apenas ao comutador NIC padrão no adaptador de rede. O membro SwitchId da estrutura NDIS_NIC_SWITCH_PARAMETERS deve ser definido como NDIS_DEFAULT_SWITCH_ID.
Comentários
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 um comutador NIC.
Nota 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.
Nota O driver de miniporto PF manipula solicitações de conjunto de OID de OID_NIC_SWITCH_PARAMETERS.
Retornar códigos de status
O driver de miniporto NDIS ou PF retorna os seguintes códigos 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 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_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_REINIT_REQUIRED |
O driver de miniporto PF requer uma reinicialização do adaptador de rede para aplicar as alterações à opção 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) |