OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES

Artigo
06/15/2023

Os drivers em excesso 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 membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estruturaNDIS_RECEIVE_FILTER_CAPABILITIES .

Comentários

Os filtros de recebimento do NDIS são usados nas seguintes interfaces NDIS:

Agrupamento de pacotes 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 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 de arquivo INF ou por meio da página Propriedades avançadas .

Nota 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 uma funcionalidade estar habilitada ou desabilitada.

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 miniporte registram esses recursos seguindo estas etapas:

O driver inicializa uma estrutura 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 miniporto chama a função NdisMSetMiniportAttributes e define o parâmetro MiniportAttributes como um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Retornar códigos de status

O NDIS manipula a solicitação de consulta OID de OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES para drivers de miniporte e retorna um dos seguintes códigos 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
A solicitação está pendente de conclusão. O NDIS passa o código 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. QUERY_INFORMATION. Membro BytesNeeded 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.