OID_NIC_SWITCH_HARDWARE_CAPABILITIES

Um driver sobreposto emite uma solicitação de consulta de identificador de objeto (OID) 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 InformationBuffer membro 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 atualmente desativados pelas configurações do arquivo INF ou por meio da página de propriedades Avançado.

Observação Todos os recursos do comutador NIC especificado são retornados por meio de uma solicitação de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES, independentemente de um recurso estar habilitado ou desabilitado.

A partir do NDIS 6.20, os drivers de miniporta fornecem os recursos de hardware do switch NIC quando sua função MiniportInitializeEx é chamada. O driver inicializa uma estrutura de NDIS_NIC_SWITCH_CAPABILITIES com os recursos de hardware do switch NIC e define o HardwareNicSwitchCapabilities membro da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES como um ponteiro para a estrutura NDIS_NIC_SWITCH_CAPABILITIES. Em seguida, o driver de miniporta chama a funçãoNdisMSetMiniportAttributes e define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Observação A partir do NDIS 6.30, os drivers de miniporta que suportam a interface de virtualização de E/S de raiz única (SR-IOV) devem registrar os recursos de hardware do switch NIC. Os drivers registram esses recursos chamando NdisMSetMiniportAttributes.

Códigos de status de retorno

O NDIS lida com a solicitação de consulta OID de OID_NIC_SWITCH_HARDWARE_CAPABILITIES solicitação para drivers de miniporta 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 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_LENGTH	O comprimento do buffer de informações é menor que sizeof(NDIS_NIC_SWITCH_CAPABILITIES). O NDIS define os DADOS. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE	O pedido foi rejeitado por outros motivos.