Méthode IPort ::Init (portcls.h)

  • Article

La méthode Init initialise le pilote de port.

Syntaxe

NTSTATUS Init(
  PVOID         DeviceObject,
  PVOID         Irp,
  PUNKNOWN      UnknownMiniport,
  PUNKNOWN      UnknownAdapter,
  PRESOURCELIST ResourceList
);

Paramètres

DeviceObject

Pointeur vers l’objet de périphérique passé en tant qu’argument à la routine de démarrage du périphérique du pilote d’adaptateur. L’objet d’appareil est une structure système de type DEVICE_OBJECT.

Irp

Pointeur vers l’IRP passé comme argument à la routine de démarrage du périphérique du pilote de l’adaptateur.

UnknownMiniport

Pointeur vers l’interface IUnknown de l’objet miniport non initialisé. Cette interface est interrogée pour l’interface miniport spécifique prise en charge par le pilote de port, et la fonction d’initialisation sur cette interface est appelée.

UnknownAdapter

Pointeur vers l’interface IUnknown de l’objet adaptateur dont le pilote de port est en cours d’initialisation. Ce pointeur est facultatif et peut être spécifié comme NULL. Pour plus d'informations, consultez la section Notes qui suit.

ResourceList

Pointeur vers l’objet IResourceList passé en tant qu’argument à la routine de démarrage du périphérique du pilote 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.

Valeur retournée

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

Remarques

L’objet miniport spécifié par UnknownMiniport doit prendre en charge l’interface miniport requise par le pilote de port, sinon l’appel Init échoue.

Pendant l’appel IPort ::Init, le pilote de port appelle la méthode d’initialisation du pilote miniport (par exemple, consultez IMiniportWavePci ::Init).

Le paramètre UnknownAdapter pointe vers l’interface COM d’un objet adaptateur. Le pilote d’adaptateur crée généralement cet objet dans sa routine de démarrage du périphérique, qui est la routine que le système d’exploitation appelle pour démarrer l’appareil (voir Séquence de démarrage). Pour obtenir un exemple d’interface pour un objet adaptateur, consultez la définition et l’implémentation CMiniportWaveRT::Init dans l’exemple de pilote audio sysvad.

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

Configuration requise

Condition requise Valeur
En-tête portcls.h
IRQL PASSIVE_LEVEL

Voir aussi

IPort

IMiniportWavePci ::init