OID_RECEIVE_FILTER_GLOBAL_PARAMETERS
Os drivers em excesso emitem solicitações de consulta OID de OID_RECEIVE_FILTER_GLOBAL_PARAMETERS para obter os parâmetros globais de filtragem de recebimento 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 de NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS .
Comentários
Os filtros de recebimento do NDIS são usados nas seguintes interfaces NDIS:
Agrupamento de pacotes NDIS. Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Gerenciando filtros de recebimento de agrupamento de pacotes.
Virtualização de E/S de Raiz Única (SR-IOV). 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áquinas Virtuais). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configuração e limpeza de filtros VMQ.
A partir do NDIS 6.20, os drivers de protocolo usam OID_RECEIVE_FILTER_GLOBAL_PARAMETERS para consultar os parâmetros de configuração globais atuais para receber filtragem em um adaptador de rede. Por exemplo, os drivers de protocolo podem usar essa OID para determinar se os tipos de filtros de recebimento ou as filas de recebimento estão habilitados ou desabilitados.
Retornar códigos de status
O NDIS manipula a solicitação de consulta OID de OID_RECEIVE_FILTER_GLOBAL_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.
NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passa o código status final e os resultados para o manipulador de conclusão da 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_INVALID_PARAMETER
A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não dá suporte.
NDIS_STATUS_FAILURE
A solicitação falhou por outros motivos.
Requisitos
Versão |
Com suporte no NDIS 6.20 e posterior. |
Cabeçalho |
Ntddndis.h (inclua Ndis.h) |