NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
O driver de miniporta emite uma indicação de status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES quando seus recursos de filtragem de recebimento atualmente habilitados mudam.
Observação Essa indicação de status só deve ser feita por drivers de miniporta que suportam filtros de recebimento NDIS.
Quando o driver de miniporta faz essa indicação de status, ele define o StatusBuffer membro da estrutura NDIS_STATUS_INDICATION como um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_CAPABILITIES. O driver inicializa essa estrutura com seus recursos de filtro de recebimento atualmente habilitados.
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.
O driver da miniporta emite a indicação de status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES quando uma das seguintes condições for verdadeira:
Os recursos de filtro de recebimento atualmente habilitados mudam em um único adaptador de rede. Por exemplo, os filtros de recebimento podem ser ativados ou desativados por meio de um aplicativo de gerenciamento desenvolvido pelo fornecedor independente de hardware (IHV).
Os recursos de filtro de recebimento atualmente habilitados mudam para um ou mais adaptadores de rede que pertencem a uma equipe de failover de balanceamento de carga (LBFO) gerenciada por um driver intermediário MUX. Para obter mais informações, consulte NDIS MUX Intermediate Drivers.
O driver de miniporta segue estas etapas quando emite a indicação de status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES:
A miniporta inicializa a estrutura NDIS_RECEIVE_FILTER_CAPABILITIES com os recursos de filtro de recebimento atualmente habilitados no adaptador de rede.
Quando o driver de miniporta inicializa o membro Cabeçalho, ele define o membro Tipo do de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. O driver de miniporta define o membro Revisão de de Cabeçalho como NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 e o membro Tamanho como NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.
O driver de miniporta inicializa uma estrutura de NDIS_STATUS_INDICATION para a indicação de status da seguinte maneira:
O StatusCode membro deve ser definido como NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.
O membro do StatusBuffer deve ser definido como o endereço da estrutura NDIS_RECEIVE_FILTER_CAPABILITIES.
O membro StatusBufferSize deve ser definido como
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).
O driver de miniporta emite a indicação de status chamando NdisMIndicateStatusEx. O driver deve passar um ponteiro para a estrutura NDIS_STATUS_INDICATION para o parâmetro StatusIndicação.
Observação Os drivers sobrepostos podem usar a indicação de status NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES para determinar os recursos de filtro de recebimento atualmente habilitados do adaptador de rede. Como alternativa, esses drivers também podem emitir solicitações de consulta OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES para obter os recursos de filtro de recebimento atualmente habilitados a qualquer momento.
Requerimentos
Versão |
Suportado no NDIS 6.30 e posterior. |
Cabeçalho |
Ndis.h (inclui Ndis.h) |