OID_RECEIVE_FILTER_PARAMETERS

Artigo
06/15/2023

Um driver sobreposto emite uma solicitação de método OID de OID_RECEIVE_FILTER_PARAMETERS para obter os parâmetros de configuração atuais de um filtro em um adaptador de rede.

O membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_PARAMETERS . O NDIS usa o membro FilterId na estrutura de entrada para identificar o filtro.

Após um retorno bem-sucedido da solicitação do método OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para um buffer. Esse buffer é formatado para conter o seguinte:

Uma estrutura NDIS_RECEIVE_FILTER_PARAMETERS que especifica os parâmetros para um filtro de recebimento de NDIS.
Uma matriz de estruturas de NDIS_RECEIVE_FILTER_FIELD_PARAMETERS que especifica o critério de teste de filtro para um campo em um cabeçalho de pacote de rede.

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.

Os drivers em excesso emitem solicitações de método OID de OID_RECEIVE_FILTER_PARAMETERS para obter os parâmetros de configuração para um filtro de recebimento que foi definido em um adaptador de rede. Isso inclui um filtro de recebimento que foi definido em uma fila de recebimento VMQ ou VPort (porta virtual SR-IOV), bem como um filtro de união de pacotes que foi baixado para o driver de miniporto.

O driver sobreposto obteve o identificador de filtro de uma solicitação de método OID anterior de OID_RECEIVE_FILTER_SET_FILTER ou de solicitações OID de OID_RECEIVE_FILTER_ENUM_FILTERS.

Retornar códigos de status

O NDIS manipula a solicitação OID de OID_RECEIVE_FILTER_PARAMETERS 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_PARAMETERS .

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_PARAMETER
O driver ou aplicativo sobressociente forneceu um identificador de filtro inválido. Um identificador de filtro não será válido se for zero ou se especificar um filtro indefinido.

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_FAILURE
A solicitação falhou por outros motivos.