IMiniportWaveCyclic::Init-Methode (portcls.h)

Artikel
02/29/2024

Die Init -Methode initialisiert das WaveCyclic-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] PPORTWAVECYCLIC Port
);

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 für 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 IPortWaveCyclic-Objekt , das an diesen Miniporttreiber gebunden ist. Der Aufrufer gibt einen gültigen Nicht-NULL-Zeiger 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 Methode des InitIPortWaveCyclic-Objekts übergeben hat (siehe IPort::Init).

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