Recupero e aggiornamento dei parametri della coda di macchine virtuali

Un driver overlying può impostare i parametri di configurazione di una coda di macchine virtuali dopo l'allocazione. Inoltre, un driver o un'applicazione overlying possono ottenere i parametri correnti per una coda e parametri per i filtri impostati in una coda.

Per modificare i parametri di configurazione correnti di una coda, i driver overlying possono usare la richiesta OID impostata OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Il driver overlying fornisce un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS nel membro InformationBufferdella strutturaNDIS_OID_REQUEST.

La struttura NDIS_RECEIVE_QUEUE_PARAMETERS viene usata nell'OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE e nell'OID OID_RECEIVE_FILTER_QUEUE_PARAMETERS . Per altre informazioni sull'allocazione delle code, vedere Allocazione di una coda di macchine virtuali.

Per ottenere i parametri di configurazione correnti di una coda, i driver overlying possono usare la richiesta OID del metodo OID_RECEIVE_FILTER_QUEUE_PARAMETERS. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene inizialmente un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS con un identificatore di tipo NDIS_RECEIVE_QUEUE_ID . Dopo aver restituito correttamente la richiesta del metodo OID, il membro InformationBuffer della struttura di NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_QUEUE_PARAMETERS .

NDIS gestisce la richiesta di metodo per i driver miniport. Pertanto, la richiesta OID del metodo OID_RECEIVE_FILTER_QUEUE_PARAMETERS non è richiesta per i driver miniport. NDIS ha ottenuto le informazioni da una cache interna dei dati ricevuti dalla OID_RECEIVE_FILTER_ALLOCATE_QUEUE e OID_RECEIVE_FILTER_QUEUE_PARAMETERS richieste OID.

Per ottenere i parametri di configurazione correnti di un filtro in una coda di ricezione, i driver overlying possono usare la richiesta OID del metodo OID_RECEIVE_FILTER_PARAMETERS . Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene inizialmente un puntatore a una struttura NDIS_RECEIVE_FILTER_PARAMETERS . NDIS usa il membro FilterId nella struttura di input per identificare il filtro. Dopo aver restituito correttamente la richiesta di metodo, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura di NDIS_RECEIVE_FILTER_PARAMETERS aggiornata.

NDIS gestisce la richiesta OID del metodo OID_RECEIVE_FILTER_PARAMETERS per i driver miniport. NDIS ha ottenuto le informazioni da una cache interna dei dati ricevuti dalla richiesta OID OID_RECEIVE_FILTER_SET_FILTER .

I driver overlying possono usare la richiesta OID del metodo OID_RECEIVE_FILTER_PARAMETERS per ottenere i parametri di configurazione per un filtro in una coda di ricezione.

Il driver overlying ha ottenuto l'identificatore di filtro da una richiesta OID del metodo OID_RECEIVE_FILTER_SET_FILTER precedente o dalla richiesta OID OID_RECEIVE_FILTER_ENUM_FILTERS . Solo i driver possono usare la richiesta di OID_RECEIVE_FILTER_SET_FILTER.

Un'applicazione ha ottenuto l'identificatore di filtro dalla richiesta OID OID_RECEIVE_FILTER_ENUM_FILTERS .