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:
União de pacotes NDIS. Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Gerenciando filtros de recebimento de união de pacotes.
Sr-IOV (Virtualização de E/S de Raiz Única).. 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áquina Virtual). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configurando e limpando 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 miniporta registram esses recursos seguindo estas etapas:
O driver inicializa uma estrutura NDIS_RECEIVE_FILTER_CAPABILITIES com os recursos de hardware de filtragem de recebimento habilitados no momento.
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 .
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) |