Méthode IPort ::Init (portcls.h)
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 |