OID_RECEIVE_FILTER_ENUM_FILTERS

Article
06/15/2023

Un pilote qui se superpose émet une demande de méthode OID de OID_RECEIVE_FILTER_ENUM_FILTERS pour obtenir la liste de tous les filtres configurés sur une carte réseau.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_FILTER_INFO_ARRAY .

Après un retour réussi à partir de la demande de méthode OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une mémoire tampon. Cette mémoire tampon est mise en forme pour contenir les éléments suivants :

Une structure NDIS_RECEIVE_FILTER_INFO_ARRAY qui spécifie une liste de filtres de réception actuellement configurés sur un pilote miniport.
Tableau de structures NDIS_RECEIVE_FILTER_INFO . Chaque structure spécifie les paramètres d’un filtre de réception actuellement configuré sur un pilote miniport.

Notes

Les filtres de réception NDIS sont utilisés dans les interfaces NDIS suivantes :

NDIS Packet Coalescing. Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de coalescing de paquets.
Virtualisation d’E/S racine unique (SR-IOV). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition d’un filtre de réception sur un port virtuel.
Virtual Machine Queue (VMQ). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition et suppression des filtres VMQ.

Les pilotes ou les applications excessives émettent des demandes de méthode OID de OID_RECEIVE_FILTER_ENUM_FILTERS pour énumérer les filtres de réception qui ont été définis sur une carte réseau. Cela inclut les filtres de réception qui ont été définis sur un port virtuel SR-IOV (VPort) ou une file d’attente de réception VMQ.

Instructions supplémentaires pour l’interface de fusion de paquets NDIS

À compter de Windows Server 2012, la fusion des paquets NDIS prend uniquement en charge la file d’attente de réception par défaut d’une carte réseau.

Pour énumérer les filtres de réception de fusion de paquets, le pilote qui se superpose doit définir le membre QueueId de la structure NDIS_RECEIVE_FILTER_INFO_ARRAY sur NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Instructions supplémentaires pour l’interface SR-IOV

À compter de Windows Server 2012, l’interface SR-IOV prend uniquement en charge la file d’attente de réception par défaut d’un port virtuel (VPort).

Pour énumérer les filtres de réception VPort, le pilote qui surclasse doit définir le membre QueueId de la structure NDIS_RECEIVE_FILTER_INFO_ARRAY sur NDIS_DEFAULT_RECEIVE_QUEUE_ID.

Instructions supplémentaires pour l’interface VMQ

Un pilote trop important peut émettre des demandes de méthode OID de OID_RECEIVE_FILTER_ENUM_FILTERS pour énumérer les filtres de réception qui ont été définis sur une file d’attente de réception VMQ. Lorsque le pilote de surdimensionnement initialise la structure NDIS_RECEIVE_FILTER_INFO_ARRAY , il définit le membre QueueId à l’une des valeurs suivantes :

Valeur d’identificateur de file d’attente pour une file d’attente de réception non par défaut. Le pilote qui se superposait a obtenu la valeur d’entrée de l’identificateur de file d’attente à partir d’une demande de méthode OID antérieure de OID_RECEIVE_FILTER_ALLOCATE_QUEUE ou d’une requête OID de OID_RECEIVE_FILTER_ENUM_QUEUES.
Valeur d’identificateur de file d’attente de NDIS_DEFAULT_RECEIVE_QUEUE_ID, qui spécifie la file d’attente de réception par défaut.

Retourner les codes status

NDIS gère la demande de méthode OID de OID_RECEIVE_FILTER_ENUM_FILTERS pour les pilotes miniport et retourne l’un des codes status suivants :

NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. InformationBuffer pointe vers une structure NDIS_RECEIVE_FILTER_INFO_ARRAY.

NDIS_STATUS_PENDING
La demande est en attente d’achèvement. NDIS transmet le code status final et les résultats au gestionnaire de saisie semi-automatique de la demande OID de l’appelant une fois la demande terminée.

NDIS_STATUS_INVALID_LENGTH
La mémoire tampon d’informations était trop courte. NDIS définit les DONNÉES. QUERY_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.

NDIS_STATUS_FAILURE
La demande a échoué pour d’autres raisons.