Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um driver em excesso emite uma solicitação de consulta OID (identificador de objeto) de OID_NIC_SWITCH_CURRENT_CAPABILITIES para obter os recursos de hardware atualmente habilitados do comutador NIC em um adaptador de rede.
Após um retorno bem-sucedido da solicitação de consulta OID, o informationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_NIC_SWITCH_CAPABILITIES.
Observações
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 CurrentNicSwitchCapabilities membro 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.
Observação Começando com o NDIS 6.30, os drivers de miniport que dão suporte à interface de virtualização de E/S raiz única (SR-IOV) devem registrar os recursos de hardware habilitados do comutador NIC. Os drivers registram esses recursos chamando NdisMSetMiniportAttributes.
Drivers de filtro e protocolos 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 NicSwitchCapabilities membro da estrutura 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 NicSwitchCapabilities membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de anexação.
Códigos de status de retorno
O NDIS manipula a solicitação de consulta OID da solicitação OID_NIC_SWITCH_CURRENT_CAPABILITIES para drivers de miniporto. Os drivers não serão emitidos nesta solicitação 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 miniporto não dá suporte à interface de virtualização de E/S raiz única (SR-IOV) 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 miniporto deve definir a DATA. QUERY_INFORMATION. BytesNeededed membro 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) |