OID_NIC_SWITCH_PARAMETERS

Artigo
06/15/2023

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.