OID_RECEIVE_FILTER_CURRENT_CAPABILITIES
Le surlysage des pilotes émet des requêtes OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES pour obtenir les fonctionnalités de filtrage de réception actuellement activées d’une carte réseau.
Après un retour réussi de la requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_FILTER_CAPABILITIES.
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 miniport inscrivent les fonctionnalités matérielles de filtrage de réception actuellement activées de la carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Les pilotes miniport inscrivent ces fonctionnalités en procédant comme suit :
Le pilote initialise une structure NDIS_RECEIVE_FILTER_CAPABILITIES avec les fonctionnalités matérielles de filtrage actuellement activées.
Le pilote initialise une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES et définit la CurrentReceiveFilterCapabilities membre sur un pointeur vers la structure NDIS_RECEIVE_FILTER_CAPABILITIES.
Le pilote miniport appelle la fonction NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes sur un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.
Le protocole de superposition et les pilotes de filtre n’ont pas besoin d’émettre des requêtes OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES. NDIS fournit les fonctionnalités de filtrage de réception actuellement activées pour ces pilotes de la manière suivante :
NDIS fournit les fonctionnalités de filtrage de réception actuellement activées d’une carte réseau sous-jacente pour superposer les pilotes de protocole dans le ReceiveFilterCapabilities membre de la structure NDIS_BIND_PARAMETERS pendant l’opération de liaison.
NDIS fournit les fonctionnalités de filtrage de réception actuellement activées d’une carte réseau sous-jacente pour superposer les pilotes de filtre dans le ReceiveFilterCapabilities membre de la structure de NDIS_FILTER_ATTACH_PARAMETERS pendant l’opération d’attachement.
Retourner des codes d’état
NDIS gère la requête de requête OID de OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 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_CAPABILITIES.
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 demande 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_NOT_SUPPORTED
La carte réseau ne prend pas en charge le filtrage de réception.
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) |