NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
O driver de miniporta emite uma indicação NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status quando os recursos de filtragem de recebimento atualmente habilitados são alterados.
Nota Essa indicação status só deve ser feita por drivers de miniporta que dão suporte a filtros de recebimento de NDIS.
Quando o driver de miniporta faz essa indicação status, ele define o membro StatusBuffer 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 de NDIS são usados nas seguintes interfaces NDIS:
União de pacotes NDIS. Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Gerenciando filtros de recebimento de união de pacotes.
Sr-IOV (Virtualização de E/S de Raiz Única).. 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áquina Virtual). Para obter mais informações sobre como usar filtros de recebimento nessa interface, consulte Configurando e limpando filtros VMQ.
O driver de miniporta emite a indicação NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status quando uma das seguintes condições é verdadeira:
Os recursos de filtro de recebimento atualmente habilitados são alterados em um único adaptador de rede. Por exemplo, os filtros de recebimento podem ser habilitados ou desabilitados por meio de um aplicativo de gerenciamento desenvolvido pelo IHV (fornecedor independente de hardware).
Os recursos de filtro de recebimento atualmente habilitados mudam para um ou mais adaptadores de rede que pertencem a uma equipe de LBFO (failover de balanceamento de carga) gerenciada por um driver intermediário MUX. Para obter mais informações, consulte Drivers intermediários do NDIS MUX.
O driver de miniporta segue estas etapas quando emite a indicação NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status:
O miniporto inicializa a estrutura NDIS_RECEIVE_FILTER_CAPABILITIES com os recursos de filtro de recebimento que estão atualmente habilitados no adaptador de rede.
Quando o driver de miniporta inicializa o membro Header , ele define o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. O driver de miniporta define o membro Revision de Header como NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 e o membro Size como NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.
O driver de miniporta inicializa uma estrutura NDIS_STATUS_INDICATION para a indicação de status da seguinte maneira:
O membro StatusCode deve ser definido como NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.
O membro 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 status chamando NdisMIndicateStatusEx. O driver deve passar um ponteiro para a estrutura NDIS_STATUS_INDICATION para o parâmetro StatusIndication .
Nota Os drivers em excesso podem usar a indicação NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES status para determinar os recursos de filtro de recebimento habilitados no momento 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.
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
parâmetro |
Ndis.h (inclua Ndis.h) |