OID_RECEIVE_FILTER_CLEAR_FILTER

Drivers sobrepostos emitem solicitações de conjunto OID de OID_RECEIVE_FILTER_CLEAR_FILTER para limpar um filtro de recebimento em um adaptador de rede.

O InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS.

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 solicitação de conjunto OID de OID_RECEIVE_FILTER_CLEAR_FILTER é obrigatória para drivers de miniporta que suportam a coalescência de pacotes NDIS, SR-IOV ou interface VMQ.

Um driver sobreposto, como um protocolo NDIS ou driver de filtro, usa a solicitação OID_RECEIVE_FILTER_CLEAR_FILTER set para limpar um filtro definido anteriormente. Somente o driver que definiu o filtro de recebimento pode limpá-lo.

O driver sobreposto limpa um filtro de recebimento definindo o FilterId membro da estrutura de NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS como o identificador do filtro. O driver obteve o identificador de filtro de uma solicitação de método OID anterior de OID_RECEIVE_FILTER_SET_FILTER.

Instruções adicionais para NDIS Packet Coalescing

O ponto a seguir se aplica a drivers de miniporta e sobreposição que suportam coalescência de pacotes NDIS:

Um driver sobreposto deve limpar todos os filtros de receção que definiu no driver da miniporta antes que ele se desligue ou se desprenda do driver.

Diretrizes adicionais para a interface SR-IOV

Os seguintes pontos se aplicam à miniporta e aos drivers sobrepostos que suportam a interface SR-IOV:

Um driver sobrejacente deve limpar todos os filtros que ele definiu em um SR-IOV VPort antes de liberar o VPort. O driver sobreposto também deve limpar todos os filtros que ele definiu no VPort padrão antes de fechar sua ligação ao adaptador de rede.
Um driver de miniporta não deve indicar pacotes em um VPort não padrão se tiver concluído a solicitação OID de OID_RECEIVE_FILTER_CLEAR_FILTER para limpar o último filtro no VPort.

Nota Um driver de miniporta também não deve indicar pacotes em um VPort não padrão se tiver concluído uma solicitação OID de OID_NIC_SWITCH_DELETE_VPORT para liberar o VPort.

Diretrizes adicionais para a interface VMQ

Os seguintes pontos se aplicam a drivers de miniporta e sobreposição que suportam a interface VMQ:

Um driver sobreposto deve limpar todos os filtros definidos em uma fila de recebimento VMQ antes de liberar a fila. O driver sobreposto também deve limpar todos os filtros que ele definiu nas filas padrão ou soltar antes de fechar sua ligação ao adaptador de rede.
Um driver de miniporta não deve indicar pacotes em uma fila de recebimento se tiver concluído a solicitação OID de OID_RECEIVE_FILTER_CLEAR_FILTER para limpar o último filtro na fila de recebimento.

Observação Um driver de miniporta também não deve indicar pacotes em uma fila de recebimento se tiver concluído uma solicitação OID de OID_RECEIVE_FILTER_FREE_QUEUE para liberar a fila de recebimento.

Códigos de status de retorno

A funçãoMiniportOidRequest do driver de miniportaretorna um dos seguintes valores para essa solicitação:

Vigência	Descrição
NDIS_STATUS_SUCCESS	O driver da miniporta concluiu a solicitação com êxito.
NDIS_STATUS_PENDING	O driver de miniporta concluirá a solicitação de forma assíncrona. Depois que o driver de miniporta tiver concluído todo o processamento, ele deverá executar a solicitação chamando a função NdisMOidRequestComplete e passando NDIS_STATUS_SUCCESS para o parâmetro Status .
NDIS_STATUS_NOT_ACCEPTED	O adaptador de miniporta foi removido surpresa.

O NDIS retorna um dos seguintes códigos de status para essa solicitação:

NDIS_STATUS_SUCCESS
O filtro especificado foi limpo com êxito.

NDIS_STATUS_PENDING
O pedido está pendente de conclusão. O NDIS passará 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_FILE_NOT_FOUND
O identificador do filtro não é válido.

NDIS_STATUS_INVALID_LENGTH
O buffer de informações é muito pequeno. O NDIS define os DADOS. SET_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.