OID_RECEIVE_FILTER_PARAMETERS

Un pilote overlying émet une demande de méthode OID de OID_RECEIVE_FILTER_PARAMETERS pour obtenir les paramètres de configuration actuels d’un filtre sur une carte réseau.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_FILTER_PARAMETERS . NDIS utilise le membre FilterId dans la structure d’entrée pour identifier le filtre.

Après un retour réussi 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 :

• Structure NDIS_RECEIVE_FILTER_PARAMETERS qui spécifie les paramètres d’un filtre de réception NDIS.

• Tableau de structures NDIS_RECEIVE_FILTER_FIELD_PARAMETERS qui spécifie le critère de test de filtre pour un champ dans un en-tête de paquet réseau.

Notes

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

• Fusion des paquets NDIS. Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de fusion 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 effacement des filtres VMQ.

Les pilotes excessivement émettent des demandes de méthode OID de OID_RECEIVE_FILTER_PARAMETERS pour obtenir les paramètres de configuration d’un filtre de réception qui a été défini sur une carte réseau. Cela inclut un filtre de réception qui a été défini sur une file d’attente de réception VMQ ou un port virtuel SR-IOV (VPort), ainsi qu’un filtre de fusion de paquets téléchargé sur le pilote miniport.

Le pilote overlying a obtenu l’identificateur de filtre à partir d’une demande de méthode OID antérieure de OID_RECEIVE_FILTER_SET_FILTER ou de requêtes OID de OID_RECEIVE_FILTER_ENUM_FILTERS.

Retourner les codes status

NDIS gère la requête OID de OID_RECEIVE_FILTER_PARAMETERS pour les pilotes miniport et retourne l’un des codes de status suivants :

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

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

NDIS_STATUS_INVALID_PARAMETER
Le pilote ou l’application qui se superposait fournissait un identificateur de filtre non valide. Un identificateur de filtre n’est pas valide s’il est égal à zéro ou s’il spécifie un filtre non défini.

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

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

Spécifications

Version	Pris en charge dans NDIS 6.20 et versions ultérieures.
En-tête	Ntddndis.h (inclure Ndis.h)

Voir aussi

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER