IMiniportDMus ::Init, méthode (dmusicks.h)

Article
02/06/2025

La méthode Init initialise l’objet miniport DMus.

Syntaxe

NTSTATUS Init(
  [in, optional] PUNKNOWN      UnknownAdapter,
  [in]           PRESOURCELIST ResourceList,
  [in]           PPORTDMUS     Port,
  [out]          PSERVICEGROUP *ServiceGroup
);

Paramètres

[in, optional] UnknownAdapter

Pointeur vers l’interface IUnknown de l’objet adaptateur dont l’objet miniport est initialisé. Ce paramètre est facultatif et peut être spécifié en tant que NULL. Pour plus d’informations, consultez la section Remarques suivante.

[in] ResourceList

Pointeur vers un objet IResourceList qui contient la liste des ressources de l’adaptateur. Après avoir transmis cette référence au pilote miniport, le pilote de port est libre d’examiner le contenu de la liste des ressources, mais ne modifie pas le contenu de cette liste.

[in] Port

Pointeur vers un objet IPortDMus qui fournit l’interface de rappel du pilote de port.

[out] ServiceGroup

Pointeur de sortie pour le groupe de services. Ce paramètre pointe vers une variable de pointeur allouée par l’appelant dans laquelle la méthode écrit un pointeur dans l’interface IServiceGroup de l’objet de groupe de services du pilote miniport. Il s’agit du groupe de services que ce pilote miniport souhaite avoir utilisé pour les appels à IPortDMus ::Notify.

Valeur de retour

Init retourne S_OK si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Le paramètre pUnknownAdapter est facultatif :

Si pUnknownAdapter n’est pasNULL, la méthode Init interroge l’objet pUnknownAdapter pour son interface IInterruptSync.
Si pUnknownAdapter est NULL, la méthode Init appelle PcNewInterruptSync pour créer un objet IInterruptSync. Dans ce cas, la liste des ressources qui pResourceList pointe pour fournir la ressource d’interruption utilisée par le nouvel objet IInterruptSync.

Dans les deux cas, la méthode Init et appelle la méthode RegisterServiceRoutine sur l’objet IInterruptSync afin d’ajouter la routine de service d’interruption du pilote miniport à la liste des ISR. Lorsque le pilote de l’adaptateur libère ultérieurement l’objet de port, le pilote de port libère sa référence à l’objet IInterruptSync.

Les paramètres pUnknownAdapter et pResourceList sont les mêmes valeurs de pointeur que le pilote de l’adaptateur passé précédemment en tant que paramètres à la méthode Init de l’objet IPortDMus (voir IPort ::Init).

Les paramètres pUnknownAdapter, pResourceList, pPortet ppServiceGroup suivent les conventions de comptage de référence pour les objets COM.