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

Article
02/23/2024

La Init méthode 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 en cours d’initialisation. Ce paramètre est facultatif et peut être spécifié comme NULL. Pour plus d'informations, consultez la section Notes qui suit.

[in] ResourceList

Pointeur vers un objet IResourceList qui contient la liste de ressources de l’adaptateur. Après avoir passé cette référence au pilote miniport, le pilote de port est libre d’examiner le contenu de la liste de 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 à l’appelant dans laquelle la méthode écrit un pointeur vers l’interface IServiceGroup de l’objet groupe de services du pilote miniport. Il s’agit du groupe de services que ce pilote miniport souhaite utiliser pour les appels à IPortDMus ::Notify.

Valeur retournée

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’a pas la valeur NULL, la Init méthode interroge l’objet pUnknownAdapter pour son interface IInterruptSync .
Si pUnknownAdapter a la valeur NULL, la Init méthode appelle PcNewInterruptSync pour créer un objet IInterruptSync . Dans ce cas, la liste de ressources que pResourceList pointe pour fournir la ressource d’interruption que le nouvel objet IInterruptSync utilise.

Dans les deux cas, la Init méthode et appelle la méthode RegisterServiceRoutine sur l’objet IInterruptSync afin d’ajouter la routine de service d’interruption (ISR) du pilote miniport à la liste des ISR. Lorsque le pilote d’adaptateur libère ultérieurement l’objet port, celui-ci 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 d’adaptateur passé précédemment en tant que paramètres à la méthode de Init l’objet IPortDMus (voir IPort ::Init).

Les paramètres pUnknownAdapter, pResourceList, pPort et ppServiceGroup suivent les conventions de comptage des références pour les objets COM.