NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS
L’état NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS indique aux pilotes NDIS et overlying que les paramètres de file d’attente de la machine virtuelle actuelle ont changé sur la carte réseau.
Remarques
Le pilote miniport doit émettre une indication d’état NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS lorsque les paramètres de file d’attente de machines virtuelles actuels ont changé sur la carte réseau. Les paramètres de file d’attente de machine virtuelle peuvent changer quand l’une des conditions suivantes est remplie :
Les paramètres de file d’attente de machines virtuelles sont modifiés par le biais d’une application de gestion développée par le fournisseur de matériel indépendant (IHV).
Les paramètres de file d’attente de machine virtuelle changent pour une ou plusieurs cartes réseau appartenant à une équipe de basculement d’équilibrage de charge (LBFO) gérée par un pilote intermédiaire MUX. Pour plus d’informations, consultez pilotes intermédiaires NDIS MUX.
Lorsque le pilote miniport émet l’indication d’état NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS, il doit suivre les étapes suivantes :
Le pilote miniport initialise une structure NDIS_RECEIVE_QUEUE_PARAMETERS avec les paramètres de file d’attente de machines virtuelles actuels sur la carte réseau. Le pilote doit également définir les indicateurs membre de cette structure avec les indicateurs NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED appropriés pour signaler les valeurs de membre NDIS_RECEIVE_QUEUE_PARAMETERS qui ont changé.
Remarque à partir de NDIS 6.30, le pilote miniport ne peut émettre qu’une indication d’état NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS pour signaler les modifications apportées au membre InterruptCoalescingDomainId.
Lorsque le pilote miniport initialise le membre d’en-tête de cette structure, il définit le membre Type de d’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Le pilote miniport définit le membre révision du d’en-tête sur NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 et le membre Size sur NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.
Le pilote miniport initialise une structure NDIS_STATUS_INDICATION de la manière suivante :
Le membre StatusCode doit être défini sur NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS.
Le membre StatusBuffer doit être défini sur le pointeur vers une structure NDIS_RECEIVE_QUEUE_PARAMETERS. Cette structure contient les fonctionnalités matérielles actuellement activées du commutateur de carte réseau.
Le membre StatusBufferSize doit être défini sur sizeof(NDIS_RECEIVE_QUEUE_PARAMETERS).
Le pilote miniport émet la notification d’état en appelant NdisMIndicateStatusEx. Le pilote doit passer un pointeur à la structure NDIS_STATUS_INDICATION au paramètre StatusIndication.
Les pilotes overlying peuvent utiliser l’indication d’état NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS pour déterminer les paramètres de file d’attente de machines virtuelles actuels sur la carte réseau. Ces pilotes peuvent également émettre des requêtes d’identificateur d’objet (OID) de OID_RECEIVE_FILTER_QUEUE_PARAMETERS pour obtenir ces paramètres à tout moment.
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ndis.h |