IPortWaveCyclic ::Notify, méthode (portcls.h)

Article
02/26/2024

La Notify méthode 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 (ISR) du pilote miniport.

Syntaxe

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

Paramètres

[in] ServiceGroup

Pointeur vers l’objet IServiceGroup du pilote miniport.

Valeur de retour

None

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 avec 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 du 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 IMiniportWaveCyclicStream ::SetNotificationFreq pour spécifier la fréquence à laquelle l’ISR doit appeler la Notify méthode. 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 des références pour les objets COM.