OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES
Les pilotes sur-ment émettent des requêtes OID de OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES pour obtenir les fonctionnalités matérielles de filtrage de réception d’une carte réseau.
Après un retour réussi de la requête de requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structureNDIS_RECEIVE_FILTER_CAPABILITIES .
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.
La structure NDIS_RECEIVE_FILTER_CAPABILITIES contient des informations sur les fonctionnalités matérielles de filtrage de réception d’une carte réseau. Ces fonctionnalités peuvent inclure des fonctionnalités matérielles actuellement désactivées par les paramètres de fichier INF ou via la page Propriétés avancées .
Note Toutes les fonctionnalités matérielles de filtrage de réception d’une carte réseau sont retournées par le biais d’une requête OID de OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES, qu’une fonctionnalité soit activée ou désactivée.
À compter de NDIS 6.20, les pilotes miniport enregistrent 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 de réception.
Le pilote initialise une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES et définit le membre CurrentReceiveFilterCapabilities 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 .
Retourner les codes status
NDIS gère la requête OID de OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES 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_CAPABILITIES.
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_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_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.
Spécifications
Version |
Pris en charge dans NDIS 6.20 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |