OID_NIC_SWITCH_CURRENT_CAPABILITIES

  • Artigo

Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_NIC_SWITCH_CURRENT_CAPABILITIES para obter os recursos de hardware atualmente habilitados da opção NIC em um adaptador de rede.

Após um retorno bem-sucedido da solicitação de consulta OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_NIC_SWITCH_CAPABILITIES .

Comentários

A partir do NDIS 6.20, os drivers de miniporto fornecem os recursos de hardware de comutador NIC atualmente habilitados no adaptador de rede quando sua função MiniportInitializeEx é chamada. O driver inicializa uma estrutura NDIS_NIC_SWITCH_CAPABILITIES com os recursos de hardware de comutador NIC e define o membro CurrentNicSwitchCapabilities da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura NDIS_NIC_SWITCH_CAPABILITIES . Em seguida, o driver de miniporto chama a função NdisMSetMiniportAttributes e define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Nota A partir do NDIS 6.30, os drivers de miniport que dão suporte à interface sr-IOV (virtualização de E/S) raiz única devem registrar os recursos de hardware habilitados da opção NIC. Os drivers registram esses recursos chamando NdisMSetMiniportAttributes.

Os drivers de protocolo e filtro sobrepostos não precisam emitir solicitações de consulta OID de OID_NIC_SWITCH_CURRENT_CAPABILITIES. O NDIS fornece os recursos de hardware de comutador NIC atualmente habilitados de um adaptador de rede para esses drivers da seguinte maneira:

  • O NDIS relata os recursos de hardware de comutador NIC atualmente habilitados de um adaptador de rede subjacente para drivers de protocolo sobressociáveis no membro NicSwitchCapabilities da estrutura de NDIS_BIND_PARAMETERS durante a operação de associação.

  • O NDIS relata os recursos de hardware de comutador NIC atualmente habilitados de um adaptador de rede subjacente para drivers de filtro sobressociáveis no membro NicSwitchCapabilities da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de anexação.

Retornar códigos de status

O NDIS manipula a solicitação de consulta OID da solicitação de OID_NIC_SWITCH_CURRENT_CAPABILITIES para drivers de miniport. Os drivers não serão emitidos nesta solicitação de OID.

Quando o NDIS manipula a solicitação OID_NIC_SWITCH_CURRENT_CAPABILITIES, ele retorna um dos seguintes códigos de status:

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 miniporte 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_LENGTH

O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_CAPABILITIES). O driver de miniporte deve definir os DADOS. QUERY_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE

A solicitação falhou por outros motivos.

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior.

Cabeçalho

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST