Définition d’un filtre de réception de fusion de paquets
Pour télécharger et définir un filtre de réception sur un pilote miniport qui prend en charge la fusion de paquets, un pilote sur-ment émet une demande de méthode OID de OID_RECEIVE_FILTER_SET_FILTER. Le membre InformationBuffer de la structure NDIS_OID_REQUEST de la requête OID contient un pointeur vers une mémoire tampon allouée à l’appelant. 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 pour un champ dans un en-tête de paquet réseau.
Pour plus d’informations sur la façon dont un pilote de superposition spécifie les paramètres d’un filtre de réception de fusion de paquets, consultez Spécification d’un filtre de réception de fusion de paquets.
Quand NDIS reçoit une demande OID pour définir un filtre de réception sur la carte réseau sous-jacente, il vérifie les paramètres de filtre de réception. Si le pilote de dépassement spécifie un nouveau filtre de réception, NDIS génère également un identificateur de filtre unique (ID) pour le filtre de réception.
Une fois que NDIS alloue les ressources nécessaires et l’ID de filtre, il transfère la requête OID au pilote miniport. Si le pilote miniport peut allouer correctement les ressources logicielles et matérielles nécessaires pour le filtre de réception, le pilote miniport termine la requête OID avec un status de NDIS_STATUS_SUCCESS.
Après un retour réussi de la demande de méthode OID de OID_RECEIVE_FILTER_SET_FILTER, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_RECEIVE_FILTER_PARAMETERS . Cette structure est mise à jour par NDIS avec le nouvel ID de filtre.