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_HARDWARE_CAPABILITIES para obter os recursos de hardware de filtragem de recebimento 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 estruturaNDIS_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 estrutura NDIS_RECEIVE_FILTER_CAPABILITIES contém informações sobre os recursos de hardware de filtragem de recebimento de um adaptador de rede. Esses recursos podem incluir recursos de hardware que estão atualmente desabilitados pelas configurações do arquivo INF ou por meio da página de propriedades Advanced.
Observação Todos os recursos de hardware de filtragem de recebimento de um adaptador de rede são retornados por meio de uma solicitação de consulta OID de OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, independentemente de um recurso estar habilitado ou desabilitado.
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.
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.
Códigos de status de retorno
O NDIS lida com a solicitação de consulta OID do OID_RECEIVE_FILTER_HARDWARE_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) |