Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un pilote surlysant é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 FilterId membre dans la structure d’entrée pour identifier le filtre.
Après un retour réussi de la requête de méthode OID, le InformationBuffer membre 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 d’un champ dans un en-tête de paquet réseau.
Remarques
Les filtres de réception NDIS sont utilisés dans les interfaces NDIS suivantes :
de 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 de filtres de réception dans cette interface, consultez Définition d’un filtre de réception sur un port virtuel.
file d’attente de machines virtuelles (VMQ). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Paramètre et effacement des filtres VMQ.
Le surlysage des pilotes émet des demandes de méthode OID de OID_RECEIVE_FILTER_PARAMETERS pour obtenir les paramètres de configuration d’un filtre de réception défini sur une carte réseau. Cela inclut un filtre de réception défini sur une file d’attente de réception VMQ ou SR-IOV port virtuel (VPort), ainsi qu’un filtre de fusion de paquets téléchargé sur le pilote miniport.
Le pilote surlysant a obtenu l’identificateur de filtre à partir d’une requête de méthode OID antérieure de OID_RECEIVE_FILTER_SET_FILTER ou à partir de requêtes OID de OID_RECEIVE_FILTER_ENUM_FILTERS.
Retourner des codes d’état
NDIS gère la requête OID de OID_RECEIVE_FILTER_PARAMETERS pour les pilotes miniports et retourne l’un des codes d’état suivants :
NDIS_STATUS_SUCCESS
La demande s’est terminée avec succès. Le InformationBuffer pointe vers une structure NDIS_RECEIVE_FILTER_PARAMETERS.
NDIS_STATUS_PENDING
La requête est en attente d’achèvement. NDIS transmet le code d’état final et les résultats au gestionnaire d’achèvement de la demande OID de l’appelant une fois la requête terminée.
NDIS_STATUS_INVALID_PARAMETER
Le pilote ou l’application surlysant a fourni 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 le DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE
La demande a échoué pour d’autres raisons.
Exigences
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |
Voir aussi
OID_RECEIVE_FILTER_ENUM_FILTERS