OID_RECEIVE_FILTER_GLOBAL_PARAMETERS
Drivers sobrepostos emitem solicitações de consulta OID de OID_RECEIVE_FILTER_GLOBAL_PARAMETERS para obter os parâmetros de filtragem de recebimento global de um adaptador de rede.
Após um retorno bem-sucedido da solicitação de consulta OID, o InformationBuffer membro da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_GLOBAL_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 partir do NDIS 6.20, os drivers de protocolo usam OID_RECEIVE_FILTER_GLOBAL_PARAMETERS para consultar os parâmetros de configuração global atuais para filtragem de recebimento em um adaptador de rede. Por exemplo, os drivers de protocolo podem usar esse OID para determinar se os tipos de filtros de recebimento ou filas de recebimento estão habilitados ou desabilitados.
Códigos de status de retorno
O NDIS lida com a solicitação de consulta OID do OID_RECEIVE_FILTER_GLOBAL_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.
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_LENGTH
O buffer de informações era muito curto. NDIS definir o DADOS. QUERY_INFORMATION. BytesNeeded membro na estrutura NDIS_OID_REQUEST para o tamanho mínimo de buffer necessário.
NDIS_STATUS_INVALID_PARAMETER
A solicitação falhou porque tentou habilitar um recurso que o adaptador de rede subjacente não suporta.
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) |