Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Drivers sobrepostos 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.
Comentários
Os filtros de recebimento NDIS são usados nas seguintes interfaces NDIS:
NDIS Packet Coalescing. Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Managing Packet Coalescing Receive Filters.
Virtualização de E/S de raiz única (SR-IOV). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Definindo um filtro de recebimento em uma porta virtual.
Fila de Máquinas Virtuais (VMQ). 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 miniporta registram os recursos de hardware de filtragem de recebimento atualmente habilitados do adaptador de rede quando sua funçãoMiniportInitializeExé chamada. Os drivers de miniporta 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 membro CurrentReceiveFilterCapabilities como um ponteiro para a estrutura NDIS_RECEIVE_FILTER_CAPABILITIES.
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.
Protocolo sobreposto e drivers de filtro 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 sobrepostos no ReceiveFilterCapabilities membro da estrutura NDIS_BIND_PARAMETERS durante a operação de ligação.
O NDIS fornece os recursos de filtragem de recebimento atualmente habilitados de um adaptador de rede subjacente para drivers de filtro sobrepostos no ReceiveFilterCapabilities membro da estrutura NDIS_FILTER_ATTACH_PARAMETERS durante a operação de anexação.
Códigos de status de retorno
O NDIS lida com a solicitação de consulta OID do OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para drivers de miniporta 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 NDIS_RECEIVE_FILTER_CAPABILITIES.
NDIS_STATUS_PENDING
O pedido está pendente de conclusão. O NDIS passa o código de status final e os resultados para o manipulador de conclusão de 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. NDIS definir o DADOS. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_NOT_SUPPORTED
O adaptador de rede não suporta filtragem de recebimento.
NDIS_STATUS_FAILURE
O pedido foi rejeitado por outros motivos.
Requerimentos
Versão |
Suportado no NDIS 6.20 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |