IPortWavePci ::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.
Syntaxe
void Notify(
[in] PSERVICEGROUP ServiceGroup
);
Paramètres
[in] ServiceGroup
Pointeur vers l’objet IServiceGroup du pilote miniport.
Valeur de retour
Aucun
Remarques
Certains pilotes miniport appellent cette méthode à partir d’un ISR en réponse à une interruption matérielle après avoir effacé la source d’interruption. D’autres pilotes appellent cette méthode à partir d’un DPC du minuteur qui est planifié pour s’exécuter à intervalles réguliers. En règle générale, seuls les pilotes qui gèrent un seul flux de rendu à partir de KMixer doivent s’appuyer sur des interruptions matérielles. Les pilotes qui prennent en charge l’accélération matérielle DirectSound doivent désactiver les interruptions matérielles et utiliser les contrôleurs de domaine du minuteur à la place. Pour plus d’informations, consultez IPortWavePciStream ::GetMapping.
Bien que le pilote miniport soit libre de choisir sa propre technique pour déterminer quand appeler cette méthode, cette méthode doit être appelée fréquemment pour permettre au pilote de port de déclencher des événements de position et d’horloge à intervalles réguliers. Le minutage de cette méthode n’est pas aussi critique que pour la méthode IPortWaveCyclique ::Notify, toutefois.
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 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 |