OID_RECEIVE_FILTER_FREE_QUEUE

Les pilotes de protocole NDIS émettent des requêtes d’identificateur d’objet (OID) définissent les requêtes de OID_RECEIVE_FILTER_FREE_QUEUE pour libérer une file d’attente de réception.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_QUEUE_FREE_PARAMETERS avec un identificateur de file d’attente de type NDIS_RECEIVE_QUEUE_ID.

Remarques

La demande de jeu OID de OID_RECEIVE_FILTER_FREE_QUEUE est facultative pour les pilotes miniport NDIS 6.20 et ultérieurs. Il est obligatoire pour les pilotes miniport qui prennent en charge l’interface de file d’attente des machines virtuelles.

Une fois qu’un pilote surlysant émet l’OID OID_RECEIVE_FILTER_ALLOCATE_QUEUE pour allouer une file d’attente de réception, il émet le OID_RECEIVE_FILTER_FREE_QUEUE OID pour libérer la file d’attente de réception.

Lorsque NDIS demande à un pilote miniport de libérer une file d’attente de réception VMQ, procédez comme suit :

1. La carte réseau arrête le transfert DMA de données pour recevoir des mémoires tampons associées à la file d’attente de réception, après quoi la file d’attente doit entrer l’état DMA Arrêté. La carte réseau a probablement arrêté l’activité DMA lorsqu’elle a reçu la requête OID OID_RECEIVE_FILTER_CLEAR_FILTER pour effacer le dernier filtre défini sur la file d’attente de réception.

2. Le pilote miniport génère une indication d’état NDIS_STATUS_RECEIVE_QUEUE_STATE avec le membre QueueState de la structure NDIS_RECEIVE_QUEUE_STATE définie sur NdisReceiveQueueOperationalStateDmaStopped pour informer NDIS que le transfert DMA a été arrêté.

3. Le pilote miniport attend que tous les paquets de réception indiqués pour que cette file d’attente soit retournée au pilote miniport.

4. Le pilote miniport libère toute la mémoire partagée allouée pour les mémoires tampons de réception de la carte réseau associées à la file d’attente en appelant NdisFreeSharedMemory.

5. Le pilote miniport termine la requête OID OID_RECEIVE_FILTER_FREE_QUEUE pour libérer la file d’attente de réception.

Les pilotes miniport appellent la fonction NdisFreeSharedMemory pour libérer de la mémoire partagée pour une file d’attente. Si le pilote miniport a alloué la mémoire partagée pour une file d’attente non définie, le pilote libère la mémoire partagée dans le contexte de l’OID OID_RECEIVE_FILTER_FREE_QUEUE pendant qu’il libère la file d’attente. Les pilotes Miniport libèrent la mémoire partagée allouée pour la file d’attente par défaut dans le contexte de la fonction MiniportHaltEx.

Un pilote overlying doit libérer tous les filtres qu’il définit sur une file d’attente avant de libérer la file d’attente. En outre, un pilote surlysant doit libérer toutes les files d’attente de réception qu’il a allouées sur une carte réseau avant d’appeler la fonction NdisCloseAdapterEx pour fermer une liaison à la carte réseau. NDIS libère toutes les files d’attente allouées sur une carte réseau avant d’appeler la fonction MiniportHaltEx du pilote miniport.

Codes d’état de retour

La fonctionminiportdu pilote miniportOidRequest retourne l’une des valeurs suivantes pour cette requête :

NDIS retourne l’un des codes d’état suivants pour cette demande :

Exigences

Voir aussi

MiniportHaltEx

NDIS_OID_REQUEST

NDIS_RECEIVE_QUEUE_FREE_PARAMETERS

NDIS_STATUS_RECEIVE_QUEUE_STATE

NdisCloseAdapterEx

NdisFreeSharedMemory

OID_RECEIVE_FILTER_ALLOCATE_QUEUE