OID_RECEIVE_FILTER_QUEUE_PARAMETERS
L'overlying driver genera richieste di metodo OID (Object Identifier) di OID_RECEIVE_FILTER_QUEUE_PARAMETERS per ottenere i parametri di configurazione correnti di una coda di ricezione. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS con un identificatore di coda di tipo NDIS_RECEIVE_QUEUE_ID. Una volta restituito correttamente dalla richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS .
I driver che emettono eccessivamente richieste di set OID di OID_RECEIVE_FILTER_QUEUE_PARAMETERS per modificare i parametri di configurazione correnti di una coda. Il driver overlying fornisce un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS nel membro InformationBuffer della struttura NDIS_OID_REQUEST .
Commenti
I driver che eseguono eccessivamente richieste di set OID di OID_RECEIVE_FILTER_QUEUE_PARAMETERS per modificare i parametri di una o più code di ricezione. La richiesta di set OID è facoltativa per i driver miniport NDIS 6.20 e versioni successive. Tuttavia, la richiesta OID è obbligatoria per i driver miniport che supportano l'interfaccia VMQ (Virtual Machine Queue).
Nota Solo il driver overlying che ha allocato la coda può modificare i parametri di configurazione inviando richieste di set OID di OID_RECEIVE_FILTER_QUEUE_PARAMETERS.
Il driver overlying ha ottenuto il valore di input dell'identificatore della coda da una richiesta OID del metodo OID_RECEIVE_FILTER_ALLOCATE_QUEUE precedente.
Dopo che il driver eccessivamente alloca una coda, può modificare i parametri di configurazione con un flag di modifica corrispondente (NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED) nel membro Flags della struttura NDIS_RECEIVE_QUEUE_PARAMETERS . Tuttavia, dopo l'allocazione della coda, il driver overlying non può modificare i parametri di configurazione che non hanno un flag di modifica corrispondente.
Codici di stato restituiti
NDIS gestisce la richiesta del metodo OID di OID_RECEIVE_FILTER_QUEUE_PARAMETERS per i driver miniport e restituisce uno dei codici di stato seguenti.
| Codice stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta è stata completata correttamente. |
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_INVALID_PARAMETER |
La richiesta non è riuscita perché ha tentato di abilitare una funzionalità non supportata dalla scheda di rete sottostante. |
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) |