Méthode IPortWavePci ::Notify (portcls.h)

Article
03/01/2024

La Notify méthode 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

None

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 à la place des DPC du minuteur. 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 suffisamment fréquemment pour permettre au pilote de port de déclencher des événements de position et d’horloge en attente à intervalles réguliers. Toutefois, le minutage de cette méthode n’est pas aussi critique que pour la méthode IPortWaveCyclic ::Notify .

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, voir Fournir des informations sur le contexte ISR). Lorsque l’interruption se produit, le système d’exploitation appelle l’ISR et transmet 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 relatives à l’objet miniport.

Le paramètre ServiceGroup suit les conventions de comptage de références pour les objets COM.