OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES

Articolo
06/15/2023

I driver che eseguono eccessivamente richieste di query OID di OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES per ottenere le funzionalità hardware di filtro di ricezione 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 strutturaNDIS_RECEIVE_FILTER_CAPABILITIES .

Commenti

I filtri di ricezione NDIS vengono usati nelle interfacce NDIS seguenti:

Unione di pacchetti NDIS. Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Managing Packet Coalescing Receive Filters.For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione su una porta virtuale.
VMQ (Virtual Machine Queue). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione e cancellazione dei filtri VMQ.

La struttura NDIS_RECEIVE_FILTER_CAPABILITIES contiene informazioni sulle funzionalità hardware di filtro di ricezione di una scheda di rete. Queste funzionalità possono includere funzionalità hardware attualmente disabilitate dalle impostazioni del file INF o tramite la pagina Delle proprietà avanzate .

Nota Tutte le funzionalità hardware di filtro di ricezione di una scheda di rete vengono restituite tramite una richiesta di query OID di OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, indipendentemente dal fatto che una funzionalità sia abilitata o disabilitata.

A partire da NDIS 6.20, i driver miniport registrano le funzionalità hardware di filtro di ricezione 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 di ricezione.
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 .

Codici di stato restituiti

NDIS gestisce la richiesta di query OID di OID_RECEIVE_FILTER_HARDWARE_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 attesa di completamento. NDIS passa il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante al termine della richiesta.

NDIS_STATUS_INVALID_LENGTH
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.

NDIS_STATUS_NOT_SUPPORTED
La scheda di rete non supporta il filtro di ricezione.

NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.