OID_RECEIVE_FILTER_ENUM_QUEUES
I driver e le applicazioni in modalità utente generano richieste di query OID (Object Identifier) di OID_RECEIVE_FILTER_ENUM_QUEUES per ottenere un elenco di tutte le code di ricezione allocate in una scheda di rete.
Una volta restituito correttamente dalla richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_QUEUE_INFO_ARRAY seguita da una struttura NDIS_RECEIVE_QUEUE_INFO per ogni filtro.
Commenti
NDIS ha ottenuto le informazioni da una cache interna dei dati ricevuti dal OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS richieste OID.
I driver e le applicazioni in modalità utente eseguono richieste di query OID di OID_RECEIVE_FILTER_ENUM_QUEUES per enumerare le code di ricezione in una scheda di rete.
Se un driver di protocollo invia la richiesta, il tipo di richiesta all'interno della struttura NDIS_OID_REQUEST è impostato su NdisRequestQueryInformation e questo OID restituisce una matrice di tutte le code di ricezione allocate dal driver di protocollo nella scheda di rete. Se un'applicazione in modalità utente ha emesso la richiesta, il tipo di richiesta all'interno della struttura NDIS_OID_REQUEST è impostato su NdisRequestQueryStatistics e questo OID restituisce una matrice di informazioni per tutte le code di ricezione nella scheda di rete.
Codici di stato restituiti
NDIS gestisce la richiesta di query OID di OID_RECEIVE_FILTER_ENUM_QUEUES per i driver miniport e restituisce uno dei codici di stato seguenti.
| Codice stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_RECEIVE_QUEUE_INFO_ARRAY. |
NDIS_STATUS_PENDING |
La richiesta è in attesa di completamento. NDIS passerà 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. METHOD_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
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) |