NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

O status do NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS indica para o NDIS e drivers sobressociantes que os parâmetros de fila da VM (máquina virtual) atuais foram alterados no adaptador de rede.

Observações

O driver de miniporto deve emitir uma indicação de status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS quando os parâmetros de fila de VM atuais foram alterados no adaptador de rede. Os parâmetros de fila de 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 de hardware independente).

  • Os parâmetros de fila de VM são alterados para um ou mais adaptadores de rede que pertencem a uma equipe de FAILOVER (failover de balanceamento de carga) gerenciada por um driver intermediário MUX. Para obter mais informações, consulte NDIS MUX Intermediate Drivers.

Quando o driver de miniporto emite a indicação de status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS, ele deve seguir estas etapas:

  1. O driver de miniporto inicializa uma estrutura de NDIS_RECEIVE_QUEUE_PARAMETERS com os parâmetros de fila de VM atuais no adaptador de rede. O driver também deve definir o Flags membro dessa estrutura com os sinalizadores de_CHANGED Xxx NDIS_RECEIVE_QUEUE_PARAMETERS_apropriados para relatar os valores de membro NDIS_RECEIVE_QUEUE_PARAMETERS que foram alterados.

    Observação Começando com o NDIS 6.30, o driver de miniporto só pode emitir uma indicação de status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS para relatar as alterações no membro InterruptCoalescingDomainId do.

Quando o driver de miniporto inicializa o membro de Cabeçalho dessa estrutura, ele define o membro tipo do de Cabeçalho como NDIS_OBJECT_TYPE_DEFAULT. O driver de miniporto define o membro de Revisão do Header como NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 e o membro tamanho para NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.

  1. 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 de NDIS_RECEIVE_QUEUE_PARAMETERS. Essa estrutura contém os recursos de hardware atualmente habilitados do comutador NIC.

    • O membro StatusBufferSize deve ser definido como sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS).

  2. O driver de miniporto emite a notificação de status chamando NdisMIndicateStatusEx. O driver deve passar um ponteiro para a estrutura de NDIS_STATUS_INDICATION para o parâmetro StatusIndication.

Drivers em excesso podem usar a indicação de status NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 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

Consulte também


NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS