IMiniportWavePci ::Init, méthode (portcls.h)

Article
02/29/2024

La Init méthode initialise l’objet miniport WavePci. L’initialisation inclut la vérification du matériel à l’aide des ressources spécifiées dans la liste des ressources.

Syntaxe

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

Paramètres

[in] UnknownAdapter

Pointeur vers l’interface IUnknown de l’objet adaptateur dont l’objet miniport est initialisé. Pour plus d'informations, consultez la section Notes qui suit.

[in] ResourceList

Pointeur vers l’interface IResourceList de l’objet de liste de ressources qui doit être fourni au pilote miniport lors de l’initialisation. 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. Pour plus d'informations, consultez la section Notes qui suit.

[in] Port

Pointeur vers l’objet d’interface IPortWavePci du pilote de port. L’appelant spécifie une valeur de pointeur non NULL valide pour ce paramètre.

[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 vers l’interface IServiceGroup de l’objet groupe de services du pilote miniport. Il s’agit du groupe de services qui est inscrit pour la notification d’interruption. L’appelant spécifie une valeur de pointeur non NULL valide pour ce paramètre.

Valeur retournée

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

Remarques

Les paramètres UnknownAdapter et ResourceList 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 IPortWavePci (voir IPort ::Init).

Les paramètres UnknownAdapter, ResourceList, Port et ServiceGroup suivent les conventions de comptage des références pour les objets COM.