Compartilhar via


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:

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)

Confira também


FilterAttach

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_NIC_SWITCH_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_ENUM_SWITCHES

ProtocolBindAdapterEx