IPort ::Init, méthode (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 d’appareil qui a été passé en tant qu’argument à la routine de démarrage de périphérique du pilote d’adaptateur. L’objet appareil est une structure système de type DEVICE_OBJECT.
Irp
Pointeur vers l’IRP qui a été passé en tant qu’argument à la routine de démarrage de périphérique du pilote d’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 initialisé. Ce pointeur est facultatif et peut être spécifié comme NULL. Pour plus d’informations, consultez la section Remarques suivante.
ResourceList
Pointeur vers l’objet IResourceList qui a été passé en tant qu’argument à la routine de démarrage de périphérique du pilote d’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.
Valeur de retour
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 ou l’appel Init échoue.
Pendant l’appel IPort ::Init, le pilote de port appelle la méthode d’initialisation du pilote miniport (par exemple, voir IMiniportWavePci ::Init).
Le paramètre UnknownAdapter pointe vers l’interface COM d’un objet adaptateur. Le pilote de l’adaptateur crée généralement cet objet dans sa routine de démarrage d’appareil, 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érence standard pour les objets COM.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | portcls.h |
| IRQL | PASSIVE_LEVEL |