NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

Le NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indique aux pilotes NDIS et aux pilotes de sur-ment que les paramètres de file d’attente de machine virtuelle actuels ont été modifiés sur la carte réseau.

Notes

Le pilote miniport doit émettre une NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication lorsque les paramètres de file d’attente de machine virtuelle actuels ont été modifiés sur la carte réseau. Les paramètres de file d’attente de machine virtuelle peuvent changer lorsque l’une des conditions suivantes est remplie :

• Les paramètres de file d’attente des machines virtuelles sont modifiés via une application de gestion développée par le fournisseur de matériel indépendant (IHV).

• Les paramètres de file d’attente des machines virtuelles changent pour une ou plusieurs cartes réseau qui appartiennent à 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 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status, il doit suivre les étapes suivantes :

1. Le pilote miniport initialise une structure NDIS_RECEIVE_QUEUE_PARAMETERS avec les paramètres de file d’attente de machine virtuelle actuels sur la carte réseau. Le pilote doit également définir le membre Flags de cette structure avec les indicateurs NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED appropriés pour signaler NDIS_RECEIVE_QUEUE_PARAMETERS valeurs de membre qui ont changé.

   Note À compter de NDIS 6.30, le pilote miniport ne peut émettre qu’un NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status indication pour signaler les modifications apportées au membre InterruptCoalescingDomainId.

Lorsque le pilote miniport initialise le membre Header de cette structure, il définit le membre Type de Header sur NDIS_OBJECT_TYPE_DEFAULT. Le pilote miniport définit le membre Revisiond’En-tête sur NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 et le membre Size sur NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2.

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).

3. Le pilote miniport émet la notification status en appelant NdisMIndicateStatusEx. Le pilote doit passer un pointeur vers la structure NDIS_STATUS_INDICATION au paramètre StatusIndication .

Les pilotes sur-ment peuvent utiliser l’indication NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS status 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.

Spécifications

Voir aussi

NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS