OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

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

Comentários

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

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

  1. O driver inicializa uma estrutura NDIS_RECEIVE_FILTER_CAPABILITIES com os recursos de hardware de filtragem de recebimento habilitados no momento.

  2. 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 .

  3. 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 .

Os drivers de protocolo e filtro de excesso 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 subjacentes no membro ReceiveFilterCapabilities 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 excessivamente no membro ReceiveFilterCapabilities 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 miniporte 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
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 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. 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.

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior.

parâmetro

Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES