OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Um driver sobreposto emite uma solicitação de consulta OID (identificador de objeto) de OID_NIC_SWITCH_HARDWARE_CAPABILITIES para obter os recursos de hardware do comutador NIC no 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 NDIS_NIC_SWITCH_CAPABILITIES .
Comentários
A estrutura NDIS_NIC_SWITCH_CAPABILITIES contém informações sobre os recursos de hardware de um comutador NIC no adaptador de rede. Esses recursos podem incluir os recursos de hardware que estão desabilitados atualmente pelas configurações de arquivo INF ou por meio da página Propriedades avançadas .
Nota Todos os recursos da opção NIC especificada são retornados por meio de uma solicitação de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES, independentemente de uma funcionalidade estar habilitada ou desabilitada.
A partir do NDIS 6.20, os drivers de miniporto fornecem as funcionalidades de hardware do comutador NIC 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 HardwareNicSwitchCapabilities 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 miniporto que dão suporte à interface SR-IOV (virtualização de E/S de raiz única) devem registrar os recursos de hardware do comutador NIC. Os drivers registram esses recursos chamando NdisMSetMiniportAttributes.
Códigos de status de retorno
O NDIS manipula a solicitação de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES solicitação de drivers de miniporto e 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 miniporta não dá suporte à interface SR-IOV (virtualização de E/S de raiz única) 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 NDIS define 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) |