Méthode IPortDMus ::RegisterServiceGroup (dmusicks.h)
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dmusicks.h (inclure Dmusicks.h) |
IRQL | PASSIVE_LEVEL |