Méthode IPortDMus ::RegisterServiceGroup (dmusicks.h)

Article
02/23/2024

La RegisterServiceGroup méthode inscrit un groupe de services auprès du pilote de port DMus.

Syntaxe

void RegisterServiceGroup(
  [in] PSERVICEGROUP ServiceGroup
);

Paramètres

[in] ServiceGroup

Pointeur vers un objet IServiceGroup . Il s’agit du groupe de services à inscrire.

Valeur de retour

None

Remarques

Le pilote miniport appelle la RegisterServiceGroup méthode pour inscrire un groupe de services (objet IServiceGroup ) auprès du pilote de port. Le pilote de port peut insérer un ou plusieurs de ses récepteurs de service (objets IServiceSink ) dans ce groupe de services. Le pilote miniport envoie une notification (en appelant IPortDMus ::Notify) au groupe de services chaque fois qu’une interruption se produit. Lors de la réception de la notification, le groupe de services planifie un appel de procédure différée (DPC). Le DPC effectue une itération dans tous les récepteurs de service dans le groupe de services et envoie une notification à chacun d’eux.

Le pilote miniport appelle généralement RegisterServiceSink pendant l’exécution de sa méthode IMiniportDMus ::Init . L’objectif de cet appel est d’inscrire le groupe de services auprès du pilote de port suffisamment tôt pour commencer à gérer les interruptions dès qu’elles sont activées. Notez que le groupe de services que la méthode Init génère n’est disponible pour le pilote de port qu’après le retour de la méthode Init .

Si le pilote miniport appelle RegisterServiceSink, le groupe de services que le pilote miniport transmet à la RegisterServiceSink méthode doit être le même que celui que le pilote miniport génère via sa méthode Init .

Un pilote miniport classique n’a plus besoin d’appeler RegisterServiceSink une fois que le retour de IMiniportDMus ::Init s’est produit.

Consultez l’exemple de pilote audio DMusUART dans le Kit de pilotes Microsoft Windows (WDK) pour obtenir un exemple de code qui montre comment le pilote miniport appelle RegisterServiceSink à partir de sa méthode IMiniportDMus ::Init .

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