OID_RECEIVE_FILTER_FREE_QUEUE

Articolo
06/15/2023

I driver del protocollo NDIS emettono richieste di set OID (OID) del set di OID_RECEIVE_FILTER_FREE_QUEUE per liberare una coda di ricezione.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_QUEUE_FREE_PARAMETERS con un identificatore della coda di tipo NDIS_RECEIVE_QUEUE_ID.

Commenti

La richiesta del set OID di OID_RECEIVE_FILTER_FREE_QUEUE è facoltativa per i driver miniport NDIS 6.20 e versioni successive. È obbligatorio per i driver miniport che supportano l'interfaccia della coda di macchine virtuali.

Dopo che un driver overlying rilascia l'OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE per allocare una coda di ricezione, rilascia l'OID OID_RECEIVE_FILTER_FREE_QUEUE per liberare la coda di ricezione.

Quando NDIS richiede a un driver miniport di liberare una coda di ricezione VMQ, seguire questa procedura:

La scheda di rete arresta il trasferimento DMA dei dati per ricevere buffer associati alla coda di ricezione, dopo la quale la coda deve immettere lo stato DMA Stopped. La scheda di rete ha probabilmente arrestato l'attività DMA quando ha ricevuto la richiesta OID OID_RECEIVE_FILTER_CLEAR_FILTER per cancellare l'ultimo filtro set nella coda di ricezione.
Il driver miniport genera un'indicazione di stato NDIS_STATUS_RECEIVE_QUEUE_STATE con il membro QueueState della struttura NDIS_RECEIVE_QUEUE_STATE impostata su NdisReceiveQueueOperationalStateDmaStopped per notificare a NDIS che il trasferimento DMA è stato arrestato.
Il driver miniport attende che tutti i pacchetti di ricezione indicati vengano restituiti al driver miniport.
Il driver miniport libera tutta la memoria condivisa allocata per i buffer di ricezione della scheda di rete associati alla coda chiamando NdisFreeSharedMemory.
Il driver miniport completa la richiesta OID OID_RECEIVE_FILTER_FREE_QUEUE per liberare la coda di ricezione.

I driver Miniport chiamano la funzione NdisFreeSharedMemory per liberare memoria condivisa per una coda. Se il driver miniport ha allocato la memoria condivisa per una coda non definita, il driver libera la memoria condivisa nel contesto dell'OID OID_RECEIVE_FILTER_FREE_QUEUE mentre libera la coda. I driver Miniport liberano memoria condivisa allocata per la coda predefinita nel contesto della funzione MiniportHaltEx .

Un driver overlying deve liberare tutti i filtri impostati su una coda prima di liberare la coda. Inoltre, un driver overlying deve liberare tutte le code di ricezione allocate in una scheda di rete prima di chiamare la funzione NdisCloseAdapterEx per chiudere un'associazione alla scheda di rete. NDIS libera tutte le code allocate su una scheda di rete prima di chiamare la funzione MiniportHaltEx del driver miniport .

Codici di stato restituiti

La funzione MiniportOidRequest del driver miniport restituisce uno dei valori seguenti per questa richiesta:

Termine	Descrizione
NDIS_STATUS_SUCCESS	Il driver miniport ha completato correttamente la richiesta.
NDIS_STATUS_PENDING	Il driver miniport completa la richiesta in modo asincrono. Dopo aver completato l'elaborazione, il driver miniport deve avere esito positivo alla richiesta chiamando la funzione NdisMOidRequestComplete , passando NDIS_STATUS_SUCCESS per il parametro Status .
NDIS_STATUS_NOT_ACCEPTED	Il driver miniport viene reimpostato.
NDIS_STATUS_REQUEST_ABORTED	Il driver miniport ha arrestato l'elaborazione della richiesta. Ad esempio, NDIS ha chiamato la funzione MiniportResetEx .

NDIS restituisce uno dei codici di stato seguenti per questa richiesta:

Codice stato	Descrizione
NDIS_STATUS_SUCCESS	La coda richiesta è stata liberata correttamente.
NDIS_STATUS_PENDING	La richiesta è in sospeso. NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID per il chiamante dopo il completamento della richiesta.
NDIS_STATUS_INVALID_PARAMETER	L'identificatore della coda non è valido.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni è troppo breve. NDIS imposta i DATI. METHOD_INFORMATION. Membro byteNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.