NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS
O NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indica para drivers NDIS e sobressociantes que os parâmetros de fila da VM (máquina virtual) atuais foram alterados no adaptador de rede.
Comentários
O driver de miniporte deve emitir um NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indicação quando os parâmetros atuais da fila de VM foram alterados no adaptador de rede. Os parâmetros da fila da VM podem ser alterados quando uma das seguintes condições for verdadeira:
Os parâmetros de fila de VM são alterados por meio de um aplicativo de gerenciamento desenvolvido pelo IHV (fornecedor independente de hardware).
Os parâmetros de fila de VM 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 Drivers Intermediários do NDIS MUX.
Quando o driver de miniporto emite o NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indicação, ele deve seguir estas etapas:
O driver de miniporto inicializa uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS com os parâmetros de fila de VM atuais no adaptador de rede. O driver também deve definir o membro Flags dessa estrutura com os sinalizadores NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED apropriados para relatar os valores de membro NDIS_RECEIVE_QUEUE_PARAMETERS que foram alterados.
Nota A partir do NDIS 6.30, o driver de miniporte só pode emitir um NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indicação para relatar alterações no membro InterruptCoalescingDomainId.
Quando o driver de miniporto inicializa o membro Header dessa estrutura, ele define o membro Type de Header como NDIS_OBJECT_TYPE_DEFAULT. O driver de miniporto define o membro Revision de Header como NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 e o membro Size como NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.
O driver de miniporto inicializa uma estrutura de NDIS_STATUS_INDICATION da seguinte maneira:
O membro StatusCode deve ser definido como NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS.
O membro StatusBuffer deve ser definido como o ponteiro para uma estrutura NDIS_RECEIVE_QUEUE_PARAMETERS . Essa estrutura contém os recursos de hardware atualmente habilitados da opção NIC.
O membro StatusBufferSize deve ser definido como sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS).
O driver de miniporte emite a notificação status chamando NdisMIndicateStatusEx. O driver deve passar um ponteiro para a estrutura NDIS_STATUS_INDICATION para o parâmetro StatusIndication .
Drivers overlying podem usar a indicação de NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status para determinar os parâmetros de fila de VM atuais no adaptador de rede. Como alternativa, esses drivers também podem emitir solicitações de consulta OID (identificador de objeto) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS para obter esses parâmetros a qualquer momento.
Requisitos
Versão |
Com suporte no NDIS 6.30 e posterior. |
Cabeçalho |
Ndis.h |