IMiniportDMus::Init-Methode (dmusicks.h)

Artikel
02/06/2025

Die Init-Methode initialisiert das DMus miniport-Objekt.

Syntax

NTSTATUS Init(
  [in, optional] PUNKNOWN      UnknownAdapter,
  [in]           PRESOURCELIST ResourceList,
  [in]           PPORTDMUS     Port,
  [out]          PSERVICEGROUP *ServiceGroup
);

Parameter

[in, optional] 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

Zeigen Sie auf ein IResourceList--Objekt, das die Ressourcenliste des Adapters enthält. Nachdem Sie diesen Verweis auf den Miniporttreiber übergeben haben, kann der Porttreiber den Inhalt der Ressourcenliste untersuchen, aber den Inhalt dieser Liste nicht ändern.

[in] Port

Zeiger auf ein IPortDMus--Objekt, das die Rückrufschnittstelle des Porttreibers bereitstellt.

[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 dieser Miniporttreiber für Anrufe an IPortDMus::Notifyverwenden möchte.

Rückgabewert

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

Bemerkungen

Der pUnknownAdapter Parameter ist optional:

Wenn pUnknownAdapter- nichtNULL-ist, fragt die Init-Methode das pUnknownAdapter-Objekt für die IInterruptSync- Schnittstelle ab.
Wenn pUnknownAdapter-NULL-ist, ruft die Init-Methode PcNewInterruptSync auf, um ein neues IInterruptSync--Objekt zu erstellen. In diesem Fall verweist die Ressourcenliste, die pResourceList auf die Interruptressource-Ressource verweist, die die neue IInterruptSync--Objekt verwendet.

In beiden Fällen ruft die Init-Methode die RegisterServiceRoutine Methode für das IInterruptSync--Objekt auf, um die Unterbrechungsdienstroutine (ISR) des Miniporttreibers zur Liste der ISRs hinzuzufügen. Wenn der Adaptertreiber das Portobjekt später freigibt, gibt der Porttreiber seinen Verweis auf das IInterruptSync--Objekt frei.

Die parameter pUnknownAdapter und pResourceList sind die gleichen Zeigerwerte, die der Adaptertreiber zuvor als Parameter an die Init Methode des IPortDMus Objekts übergeben hat (siehe IPort::Init).

Die pUnknownAdapter, pResourceList, pPortund ppServiceGroup Parameter folgen den Konventionen für die Verweiszählung für COM-Objekte.