OID_RECEIVE_FILTER_GLOBAL_PARAMETERS
Le surlysage des pilotes émet des requêtes OID de OID_RECEIVE_FILTER_GLOBAL_PARAMETERS pour obtenir les paramètres de filtrage de réception globaux d’une carte réseau.
Après un retour réussi de la requête OID, l'InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS.
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.
À compter de NDIS 6.20, les pilotes de protocole utilisent OID_RECEIVE_FILTER_GLOBAL_PARAMETERS pour interroger les paramètres de configuration globaux actuels pour le filtrage de réception sur une carte réseau. Par exemple, les pilotes de protocole peuvent utiliser cet OID pour déterminer si les types de filtres de réception ou de files d’attente de réception sont activés ou désactivés.
Retourner des codes d’état
NDIS gère la requête de requête OID de OID_RECEIVE_FILTER_GLOBAL_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.
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_LENGTH
La mémoire tampon d’informations était trop courte. NDIS définit la DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_INVALID_PARAMETER
La requête a échoué, car elle a essayé d’activer une fonctionnalité que la carte réseau sous-jacente ne prend pas en charge.
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) |