IMiniportMidi::Init-Methode (portcls.h)

Artikel
02/07/2025

Die Init-Methode initialisiert das MIDI-Miniportobjekt.

Syntax

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

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 IResourceList Schnittstelle des Ressourcenlistenobjekts, das während der Initialisierung an den Miniporttreiber bereitgestellt werden soll. Nachdem Sie diesen Verweis auf den Miniporttreiber übergeben haben, kann der Porttreiber den Inhalt der Ressourcenliste untersuchen, aber den Inhalt dieser Liste nicht ändern. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] Port

Zeiger auf das IPortMidi-Objekt, das an dieses Miniportobjekt gebunden ist. Der Aufrufer gibt einen gültigen, nichtNULL Zeigerwert 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 die Unterbrechungsbenachrichtigung registriert wird. Der Aufrufer gibt einen gültigen, nichtNULL Zeigerwert für diesen Parameter an.

Rückgabewert

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

Bemerkungen

Der parameter UnknownAdapter ist optional:

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

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

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

Die Parameter UnknownAdapter, ResourceList, Portund ServiceGroup Parameter folgen den Konventionen für die Verweiszählung von COM-Objekten.