OID_NIC_SWITCH_PARAMETERS

Um driver sobreposto emite uma solicitação de método de identificador de objeto (OID) 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 lida com essas solicitações de método OID para o driver de miniporta.

Os 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 OID são emitidas para o driver de miniporta da função física (PF) PCI Express (PCIe) do adaptador de rede. Essas solicitações de conjunto OID são necessárias para drivers de miniporta PF que suportam a interface de virtualização de E/S de raiz única (SR-IOV).

O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_PARAMETERS.

O driver sobreposto especifica o comutador NIC para o método OID ou a solicitação set definindo o SwitchId membro da estrutura NDIS_NIC_SWITCH_PARAMETERS para o identificador do switch. O driver sobrejacente obtém o identificador do switch através de uma das seguintes maneiras:

De uma solicitação de método OID anterior de OID_NIC_SWITCH_ENUM_SWITCHES.
A partir do NicSwitchArray membro da estrutura NDIS_BIND_PARAMETERS. NDIS passa um ponteiro para essa estrutura no BindParameters parâmetro da funçãoProtocolBindAdapterEx.
A partir do NicSwitchArray membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS. O NDIS passa um ponteiro para essa estrutura no AttachParameters parâmetro da funçãoFilterAttach .

Nota A partir do Windows Server 2012, o Windows suporta apenas o comutador NIC predefinido na placa de rede. O SwitchId membro da estrutura NDIS_NIC_SWITCH_PARAMETERS deve ser definido como NDIS_DEFAULT_SWITCH_ID.

Comentários

O driver sobrejacente emite 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 switch NIC especificado. Para obter mais informações, consulte Consultando os parâmetros de um switch NIC.

Nota o NDIS lida com solicitações de método OID de OID_NIC_SWITCH_PARAMETERS para o driver de miniporta PF.
O driver sobreposto emite uma solicitação de conjunto OID de OID_NIC_SWITCH_PARAMETERS para alterar os parâmetros atuais de um switch NIC especificado. Para obter mais informações, consulte Definindo os parâmetros de um switch NIC.

Nota O driver de miniporta PF lida com solicitações de conjunto OID de OID_NIC_SWITCH_PARAMETERS.

Códigos de status de retorno

NDIS ou o driver de miniporta PF retorna os seguintes códigos de status para solicitações OID de conjunto ou 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 miniporta PF não suporta a interface de virtualização de E/S de 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. NDIS ou o driver de miniporta PF define o DATA. METHOD_INFORMATION. BytesNeeded membro (para solicitações de método OID) ou DATA. SET_INFORMATION. BytesNeeded membro (para solicitações de conjunto OID) na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_REINIT_REQUIRED	O driver de miniporta PF requer uma reinicialização do adaptador de rede para aplicar as alterações ao switch NIC.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.