OID_RECEIVE_FILTER_ENUM_FILTERS

Artigo
06/15/2023

Um driver sobreposto emite uma solicitação de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para obter uma lista de todos os filtros configurados em um adaptador de rede.

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

Após um retorno bem-sucedido da solicitação de 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_INFO_ARRAY que especifica uma lista de filtros de recebimento configurados atualmente em um driver de miniporto.
Uma matriz de estruturas de NDIS_RECEIVE_FILTER_INFO . Cada estrutura especifica os parâmetros de um filtro de recebimento que está atualmente configurado em um driver de miniporto.

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.

Drivers ou aplicativos em excesso emitem solicitações de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para enumerar os filtros de recebimento que foram definidos em um adaptador de rede. Isso inclui filtros de recebimento que foram definidos em uma VPort (porta virtual SR-IOV) ou uma fila de recebimento de VMQ.

Diretrizes adicionais para a interface de união de pacotes NDIS

Começando com Windows Server 2012, o agrupamento de pacotes NDIS dá suporte apenas à fila de recebimento padrão de um adaptador de rede.

Para enumerar os filtros de recebimento de agrupamento de pacotes, o driver sobreposto deve definir o membro QueueId da estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY como NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Diretrizes adicionais para a interface SR-IOV

Começando com Windows Server 2012, a interface SR-IOV dá suporte apenas à fila de recebimento padrão de uma porta virtual (VPort).

Para enumerar os filtros de recebimento de VPort, o driver sobreposto deve definir o membro QueueId da estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY como NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Diretrizes adicionais para a interface VMQ

Um driver sobreposto pode emitir solicitações de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para enumerar os filtros de recebimento que foram definidos em uma fila de recebimento de VMQ. Quando o driver sobreposto inicializa a estrutura NDIS_RECEIVE_FILTER_INFO_ARRAY , ele define o membro QueueId como um dos seguintes valores:

O valor do identificador de fila para uma fila de recebimento não padrão. O driver sobreposto obteve o valor de entrada do identificador de fila de uma solicitação de método OID anterior de OID_RECEIVE_FILTER_ALLOCATE_QUEUE ou uma solicitação de consulta OID de OID_RECEIVE_FILTER_ENUM_QUEUES.
O valor do identificador de fila de NDIS_DEFAULT_RECEIVE_QUEUE_ID, que especifica a fila de recebimento padrão.

Retornar códigos de status

O NDIS manipula a solicitação de método OID de OID_RECEIVE_FILTER_ENUM_FILTERS para drivers de miniporte e retorna um dos seguintes códigos status:

NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito. O InformationBuffer aponta para uma estrutura de NDIS_RECEIVE_FILTER_INFO_ARRAY .

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