IPortWaveCyclique ::Notify, méthode (portcls.h)
La méthode Notify avertit le pilote de port qu’une interruption indiquant la progression du pointeur DMA s’est produite. Il doit être appelé à partir de la routine de service d’interruption du pilote miniport (ISR).
Syntaxe
void Notify(
[in] PSERVICEGROUP ServiceGroup
);
Paramètres
[in] ServiceGroup
Pointeur vers l’objet IServiceGroup du pilote miniport.
Valeur de retour
Aucun
Remarques
Cette méthode est essentielle pour un minutage précis. Les pilotes Miniport appellent généralement cette méthode en réponse à une interruption de notification après avoir effacé la source d’interruption. Bien que le pilote miniport soit libre d’utiliser d’autres méthodes pour déterminer quand appeler cette méthode, le minutage précis est important et doit être maintenu.
Lorsqu’un pilote d’adaptateur installe un ISR, il envoie un paramètre ServiceContext ainsi que le point d’entrée de l’ISR (pour plus d’informations, consultez Fournir des informations de contexte ISR). Lorsque l’interruption se produit, le système d’exploitation appelle l’ISR et passe ServiceContext en tant que paramètre d’appel à l’ISR. Bien que la signification du paramètre ServiceContext soit connue uniquement pour le développeur du pilote, il s’agit généralement d’un pointeur vers l’objet miniport. L’ISR utilise ce pointeur pour accéder aux informations sur l’objet miniport.
Le pilote de port appelle la méthode IMiniportWaveCycliqueStream ::SetNotificationFreq pour spécifier la fréquence à laquelle l’ISR doit appeler la méthode Notify. Dans toutes les versions actuelles de Windows, le pilote de port spécifie un intervalle régulier de 10 millisecondes entre les notifications successives. Cette valeur peut changer dans une version ultérieure.
Le paramètre ServiceGroup suit les conventions de comptage de référence pour les objets COM.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | N’importe quel niveau |