OID_RECEIVE_FILTER_PARAMETERS
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 InformationBuffer membro 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 InformationBuffer membro 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 NDIS.
Uma matriz de estruturas 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 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.
Drivers sobrepostos 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 SR-IOV porta virtual (VPort), bem como um filtro de coalescência de pacotes que foi baixado para o driver de miniporta.
O driver sobrejacente 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.
Códigos de status de retorno
O NDIS lida com a solicitação OID de OID_RECEIVE_FILTER_PARAMETERS para drivers de miniporta 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
O pedido 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 sobrejacente fornecia um identificador de filtro inválido. Um identificador de filtro não é 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. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_FAILURE
O pedido foi rejeitado por outros motivos.
Requerimentos
Versão |
Suportado no NDIS 6.20 e posterior. |
Cabeçalho |
Ntddndis.h (inclui Ndis.h) |
Ver também
OID_RECEIVE_FILTER_ENUM_FILTERS