OID_NIC_SWITCH_CURRENT_CAPABILITIES
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) |