OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
Drivers em excesso emitem solicitações de consulta OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para obter os recursos de filtragem de recebimento atualmente habilitados de 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_RECEIVE_FILTER_CAPABILITIES.
Observações
Os filtros de recebimento do NDIS são usados nas seguintes interfaces NDIS:
de coalescing de pacote NDIS . Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Gerenciando filtros de recebimento de agrupamento de pacotes.
virtualização de E/S de Raiz Única (SR-IOV). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configurando um filtro de recebimento em uma porta virtual.
VMQ (Fila de Máquinas Virtuais). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configuração e limpeza de filtros VMQ.
A partir do NDIS 6.20, os drivers de miniporto registram os recursos de hardware de filtragem de recebimento atualmente habilitados do adaptador de rede quando sua função MiniportInitializeEx é chamada. Os drivers de miniporto registram esses recursos seguindo estas etapas:
O driver inicializa uma estrutura de NDIS_RECEIVE_FILTER_CAPABILITIES com os recursos de hardware de filtragem de recebimento atualmente habilitados.
O driver inicializa uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES e define o currentReceiveFilterCapabilities membro para um ponteiro para a estrutura NDIS_RECEIVE_FILTER_CAPABILITIES.
O driver de miniporto chama a funçãoNdisMSetMiniportAttributese define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.
Drivers de filtro e protocolos sobrepostos não precisam emitir solicitações de consulta OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. O NDIS fornece os recursos de filtragem de recebimento atualmente habilitados para esses drivers da seguinte maneira:
O NDIS fornece os recursos de filtragem de recebimento atualmente habilitados de um adaptador de rede subjacente para drivers de protocolo sobressociáveis no ReceiveFilterCapabilities membro da estrutura NDIS_BIND_PARAMETERS durante a operação de associação.
O NDIS fornece os recursos de filtragem de recebimento atualmente habilitados de um adaptador de rede subjacente para drivers de filtro sobressociáveis no ReceiveFilterCapabilities membro 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 de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para drivers de miniporto e retorna um dos seguintes códigos de status:
NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito. O InformationBuffer aponta para uma estrutura de NDIS_RECEIVE_FILTER_CAPABILITIES.
NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passa o código de status final e os resultados para o manipulador de conclusão da solicitação OID do chamador após a conclusão da solicitação.
NDIS_STATUS_INVALID_LENGTH
O buffer de informações era muito curto. O NDIS define os dados de . QUERY_INFORMATION. BytesNeededed membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.
NDIS_STATUS_NOT_SUPPORTED
O adaptador de rede não dá suporte à filtragem de recebimento.
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) |