OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
L'overlying driver rilascia richieste di query OID di OID_RECEIVE_FILTER_CURRENT_CAPABILITIES per ottenere le funzionalità di filtro di ricezione attualmente abilitate di una scheda di rete.
Dopo aver restituito correttamente la richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_FILTER_CAPABILITIES .
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.
A partire da NDIS 6.20, i driver miniport registrano le funzionalità hardware di filtro attualmente abilitate della scheda di rete quando viene chiamata la funzione MiniportInitializeEx . I driver Miniport registrano queste funzionalità seguendo questa procedura:
Il driver inizializza una struttura NDIS_RECEIVE_FILTER_CAPABILITIES con le funzionalità hardware di filtro attualmente abilitate.
Il driver inizializza una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES e imposta il membro CurrentReceiveFilterCapabilities su un puntatore alla struttura NDIS_RECEIVE_FILTER_CAPABILITIES .
Il driver miniport chiama la funzione NdisMSetMiniportAttributes e imposta il parametro MiniportAttributes su un puntatore a una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
I driver di filtro e protocollo overlying non devono inviare richieste di query OID di OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS offre le funzionalità di filtro di ricezione attualmente abilitate per questi driver nel modo seguente:
NDIS fornisce le funzionalità di filtro di ricezione attualmente abilitate di una scheda di rete sottostante per eseguire l'overlying dei driver di protocollo nel membro ReceiveFilterCapabilities della struttura NDIS_BIND_PARAMETERS durante l'operazione di associazione.
NDIS fornisce le funzionalità di filtro attualmente abilitate di una scheda di rete sottostante per filtrare i driver nel membro ReceiveFilterCapabilities della struttura NDIS_FILTER_ATTACH_PARAMETERS durante l'operazione di collegamento.
Codici di stato restituiti
NDIS gestisce la richiesta di query OID di OID_RECEIVE_FILTER_CURRENT_CAPABILITIES per i driver miniport e restituisce uno dei codici di stato seguenti:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_RECEIVE_FILTER_CAPABILITIES.
NDIS_STATUS_PENDING
La richiesta è in sospeso. NDIS passa il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante dopo il completamento della richiesta.
NDIS_STATUS_INVALID_LENGTH
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alla dimensione minima del buffer necessaria.
NDIS_STATUS_NOT_SUPPORTED
La scheda di rete non supporta il filtro.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |