Partager via


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 :

Notes

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

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