NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS
Lo stato NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS indica a NDIS e driver eccessivamente modificati nei parametri della coda della macchina virtuale corrente nella scheda di rete.
Commenti
Il driver miniport deve emettere un'indicazione di stato NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS quando i parametri correnti della coda di macchine virtuali sono stati modificati nella scheda di rete. I parametri della coda di macchine virtuali possono cambiare quando si verifica una delle condizioni seguenti:
I parametri della coda delle macchine virtuali vengono modificati tramite un'applicazione di gestione sviluppata dal fornitore di hardware indipendente (IHV).
I parametri della coda di macchine virtuali cambiano per una o più schede di rete appartenenti a un team di failover di bilanciamento del carico gestito da un driver intermedio MUX. Per altre informazioni, vedere Driver intermedi MUX NDIS.
Quando il driver miniport rilascia l'indicazione dello stato NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS , deve seguire questa procedura:
Il driver miniport inizializza una struttura NDIS_RECEIVE_QUEUE_PARAMETERS con i parametri della coda di macchine virtuali correnti nella scheda di rete. Il driver deve anche impostare il membro Flags di questa struttura con i flag NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED appropriati per segnalare NDIS_RECEIVE_QUEUE_PARAMETERS valori membro modificati .
Nota A partire da NDIS 6.30, il driver miniport può emettere solo un'indicazione di stato NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS per segnalare le modifiche apportate al membro InterruptCoalescingDomainId .
Quando il driver miniport inizializza il membro Header di questa struttura, imposta il membro Type di Header su NDIS_OBJECT_TYPE_DEFAULT. Il driver miniport imposta il membro Revision di Header su NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 e il membro Size su NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.
Il driver miniport inizializza una struttura NDIS_STATUS_INDICATION nel modo seguente:
Il membro StatusCode deve essere impostato su NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS.
Il membro StatusBuffer deve essere impostato sul puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS . Questa struttura contiene le funzionalità hardware attualmente abilitate del commutatore della scheda di interfaccia di rete.
Il membro StatusBufferSize deve essere impostato su sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS).
Il driver miniport invia la notifica di stato chiamando NdisMIndicateStatusEx. Il driver deve passare un puntatore alla struttura NDIS_STATUS_INDICATION al parametro StatusIndication .
I driver eccessivamente possono usare l'indicazione dello stato NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS per determinare i parametri correnti della coda di macchine virtuali nella scheda di rete. In alternativa, questi driver possono anche inviare richieste di query OID (Object Identifier) di OID_RECEIVE_FILTER_QUEUE_PARAMETERS per ottenere questi parametri in qualsiasi momento.
Requisiti
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ndis.h |