NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
Il driver miniport genera un'indicazione di stato NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES quando le funzionalità di filtro attualmente abilitate cambiano.
Nota Questa indicazione di stato deve essere effettuata solo dai driver miniport che supportano i filtri di ricezione di NDIS.
Quando il driver miniport indica questo stato, imposta il membro StatusBuffer della struttura NDIS_STATUS_INDICATION su un puntatore a una struttura NDIS_RECEIVE_FILTER_CAPABILITIES . Il driver inizializza questa struttura con le relative funzionalità di filtro di ricezione attualmente abilitate.
Commenti
I filtri di ricezione NDIS vengono usati nelle interfacce NDIS seguenti:
Unione dei pacchetti NDIS. Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Gestione dei filtri di ricezione del carbone dei pacchetti.
Virtualizzazione I/O radice singola (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione in una porta virtuale.
VMQ (Virtual Machine Queue). Per altre informazioni sull'uso dei filtri di ricezione in questa interfaccia, vedere Impostazione e cancellazione dei filtri VMQ.
Il driver miniport rilascia l'indicazione di stato NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES quando una delle condizioni seguenti è true:
Le funzionalità di filtro di ricezione attualmente abilitate cambiano in una singola scheda di rete. Ad esempio, i filtri di ricezione possono essere abilitati o disabilitati tramite un'applicazione di gestione sviluppata dal fornitore hardware indipendente (IHV).
Le funzionalità di filtro di ricezione attualmente abilitate 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 NDIS MUX.
Il driver miniport segue questi passaggi quando genera l'indicazione dello stato di NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES :
Il miniport inizializza la struttura NDIS_RECEIVE_FILTER_CAPABILITIES con le funzionalità di filtro di ricezione attualmente abilitate nella scheda di rete.
Quando il driver miniport inizializza il membro Intestazione , imposta il membro Type di Intestazione su NDIS_OBJECT_TYPE_DEFAULT. Il driver miniport imposta il membro Revision di Intestazione su NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2 e il membro Size su NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2.
Il driver miniport inizializza una struttura NDIS_STATUS_INDICATION per l'indicazione dello stato nel modo seguente:
Il membro StatusCode deve essere impostato su NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES.
Il membro StatusBuffer deve essere impostato sull'indirizzo della struttura NDIS_RECEIVE_FILTER_CAPABILITIES .
Il membro StatusBufferSize deve essere impostato su
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES).
Il driver miniport genera l'indicazione dello stato chiamando NdisMIndicateStatusEx. Il driver deve passare un puntatore alla struttura NDIS_STATUS_INDICATION al parametro StatusIndication .
Nota I driver overlying possono usare l'indicazione di stato NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES per determinare le funzionalità di filtro di ricezione attualmente abilitate della scheda di rete. In alternativa, questi driver possono anche inviare richieste di query OID di OID_RECEIVE_FILTER_CURRENT_CAPABILITIES per ottenere le funzionalità di filtro di ricezione attualmente abilitate in qualsiasi momento.
Requisiti
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ndis.h (include Ndis.h) |