OID_NIC_SWITCH_CURRENT_CAPABILITIES

Um driver sobreposto emite uma solicitação de consulta de identificador de objeto (OID) 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.

Comentários

A partir do NDIS 6.20, os drivers de miniporta fornecem os recursos de hardware do comutador NIC atualmente habilitados no adaptador de rede quando sua funçãoMiniportInitializeExé chamada. O driver inicializa uma estrutura NDIS_NIC_SWITCH_CAPABILITIES com os recursos de hardware do switch 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 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 habilitados do switch NIC. Os drivers registram esses recursos chamando NdisMSetMiniportAttributes.

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

O NDIS relata os recursos de hardware de switch NIC atualmente habilitados de um adaptador de rede subjacente para drivers de protocolo sobrepostos no NicSwitchCapabilities membro da estrutura de NDIS_BIND_PARAMETERS durante a operação de ligação.
O NDIS relata os recursos de hardware de switch NIC atualmente habilitados de um adaptador de rede subjacente para drivers de filtro sobrepostos no NicSwitchCapabilities membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de conexão.

Códigos de status de retorno

O NDIS lida com a solicitação de consulta OID da solicitação de OID_NIC_SWITCH_CURRENT_CAPABILITIES para drivers de miniporta. Os drivers não serão emitidos esta solicitação OID.

Quando o NDIS lida com a solicitação de 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 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 driver da miniporta deve definir a DATA. 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.