IMiniportTopology::Init-Methode (portcls.h)

Artikel
02/27/2024

Die Init -Methode initialisiert das Topologie-Miniportobjekt.

Syntax

NTSTATUS Init(
  [in] PUNKNOWN      UnknownAdapter,
  [in] PRESOURCELIST ResourceList,
  [in] PPORTTOPOLOGY Port
);

Parameter

[in] UnknownAdapter

Zeiger auf die IUnknown-Schnittstelle des Adapterobjekts, dessen Miniportobjekt initialisiert wird. Dieser Parameter ist optional und kann als NULL angegeben werden. 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 an den Miniporttreiber übergeben wurde, kann der Porttreiber den Inhalt der Ressourcenliste untersuchen, ändert jedoch den Inhalt dieser Liste nicht. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] Port

Zeiger auf das IPortTopology-Objekt , das an dieses Miniportobjekt gebunden ist. Der Aufrufer gibt einen gültigen Zeigerwert ungleich NULL für diesen Parameter an.

Rückgabewert

Init gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Die Parameter UnknownAdapter und ResourceList sind dieselben Zeigerwerte, die der Adaptertreiber zuvor als Parameter an die Init-Methode des IPortTopology-Objekts übergeben hat (siehe IPort::Init).

Die Parameter UnknownAdapter, ResourceList und Port folgen den Referenzzählungskonventionen für COM-Objekte.