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)

Vedi anche

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_PARAMETERS

OID_RECEIVE_FILTER_ALLOCATE_QUEUE

OID_RECEIVE_FILTER_QUEUE_PARAMETERS