IMiniportWavePci::Init-Methode (portcls.h)
Die Init
-Methode initialisiert das WavePci-Miniportobjekt. Die Initialisierung umfasst die Überprüfung der Hardware mithilfe der in der Ressourcenliste angegebenen Ressourcen.
Syntax
NTSTATUS Init(
[in] PUNKNOWN UnknownAdapter,
[in] PRESOURCELIST ResourceList,
[in] PPORTWAVEPCI Port,
[out] PSERVICEGROUP *ServiceGroup
);
Parameter
[in] UnknownAdapter
Zeiger auf die IUnknown-Schnittstelle des Adapterobjekts, dessen Miniportobjekt initialisiert wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[in] ResourceList
Zeiger auf die IResourceList-Schnittstelle des Ressourcenlistenobjekts, das während der Initialisierung an den Miniporttreiber bereitgestellt werden soll. Nachdem dieser Verweis auf den Miniporttreiber übergeben wurde, kann der Porttreiber den Inhalt der Ressourcenliste untersuchen, ändert jedoch nicht den Inhalt dieser Liste. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[in] Port
Zeiger auf das IPortWavePci-Schnittstellenobjekt des Porttreibers. Der Aufrufer gibt einen gültigen Zeigerwert ohne NULL für diesen Parameter an.
[out] ServiceGroup
Ausgabezeiger für die Dienstgruppe. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene Zeigervariable, in die die -Methode einen Zeiger auf die IServiceGroup-Schnittstelle des Dienstgruppenobjekts des Miniporttreibers schreibt. Dies ist die Dienstgruppe, die für Unterbrechungsbenachrichtigungen registriert wird. Der Aufrufer gibt einen gültigen Zeigerwert ohne NULL für diesen Parameter an.
Rückgabewert
Init
gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen entsprechenden Fehlercode zurück.
Hinweise
Die Parameter UnknownAdapter und ResourceList sind dieselben Zeigerwerte, die der Adaptertreiber zuvor als Parameter an die Init-Methode des IPortWavePci-Objekts übergeben hat (siehe IPort::Init).
Die Parameter UnknownAdapter, ResourceList, Port und ServiceGroup folgen den Referenzzählungskonventionen für COM-Objekte.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Universell |
Header | portcls.h (include Portcls.h) |
IRQL | PASSIVE_LEVEL |