Compartilhar via

OID_RECEIVE_FILTER_MOVE_FILTER

  • Artigo

Um driver sobreposto emite uma solicitação de conjunto de OID (identificador de objeto) de OID_RECEIVE_FILTER_MOVE_FILTER para mover um filtro de recebimento configurado anteriormente. Os filtros de recebimento são movidos de uma porta virtual (VPort) para uma VPort diferente.

Drivers sobrepostos emitem essa solicitação de conjunto de OID para o driver de miniporto para a PF (Função Física PCIe) do adaptador de rede. Essa solicitação de conjunto de OID é necessária para drivers de miniporte PF que dão suporte à interface sr-IOV (virtualização de E/S) raiz única.

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

Comentários

O NDIS valida os membros da estrutura de NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS antes de encaminhar a solicitação de conjunto de OID para o driver de miniporto PF.

O driver de miniporto PF deve lidar com essa solicitação de conjunto de OID atomicamente. O driver deve ser capaz de configurar o adaptador de rede para remover simultaneamente o filtro de uma fila de recebimento e VPort e defini-lo em uma fila de recebimento diferente e VPort.

Para obter mais informações, consulte Movendo um filtro de recebimento para uma porta virtual.

Retornar códigos de status

O driver de miniporto PF retorna um dos seguintes códigos de status para a solicitação de conjunto de OID de OID_RECEIVE_FILTER_MOVE_FILTER.

Código de status Descrição

NDIS_STATUS_SUCCESS

A solicitação OID foi concluída com êxito.

NDIS_STATUS_NOT_SUPPORTED

O driver de miniporto PF não dá suporte à interface sr-IOV (virtualização de E/S raiz) ou não está habilitado para usar a interface.

NDIS_STATUS_INVALID_PARAMETER

Um ou mais dos membros da estrutura NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS têm valores inválidos.

NDIS_STATUS_INVALID_LENGTH

O comprimento do buffer de informações é menor que sizeof(NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS). O driver de miniporto PF deve definir os DADOS. SET_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.

Requisitos

Versão

Com suporte no NDIS 6.30 e posterior.

Cabeçalho

 Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_MOVE_FILTER_PARAMETERS