IMiniportMidi：：Init 方法（portcls.h）

發行項
02/07/2025

Init 方法會初始化MIDI迷你埠物件。

語法

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

參數

[in] UnknownAdapter

IUnknown 初始化迷你埠物件的配接器物件的介面指標。這個參數是選擇性的，而且可以指定為 NULL 。如需詳細資訊，請參閱下列一節。

[in] ResourceList

IResourceList 初始化期間提供給迷你埠驅動程式之資源清單物件的介面指標。將此參考傳遞至迷你埠驅動程序之後，埠驅動程式可以自由檢查資源清單的內容，但不會修改此列表的內容。如需詳細資訊，請參閱下列一節。

[in] Port

系結至這個迷你埠物件的 IPortMidi 物件的指標。呼叫端會指定此參數的有效、非NULL 指標值。

[out] ServiceGroup

服務群組的輸出指標。此參數指向呼叫端配置的指標變數，方法會將指標寫入迷你埠驅動程式服務群組物件的 IServiceGroup 介面。這是正在註冊以接收中斷通知的服務群組。呼叫端會指定此參數的有效、非NULL 指標值。

傳回值

如果呼叫成功，Init 會傳回STATUS_SUCCESS。否則，方法會傳回適當的錯誤碼。

言論

UnknownAdapter 參數是選擇性的：

如果 UnknownAdapter 為非NULL，Init 方法會查詢其 IInterruptSync 介面的 UnknownAdapter 物件。
如果 UnknownAdapterNULL，Init 方法會呼叫 PcNewInterruptSync 來建立新的 IInterruptSync 物件。在此情況下，ResourceList 指向的資源清單會提供新 IInterruptSync 物件所使用的中斷資源。

不論是哪一種情況，Init 方法，並在 IInterruptSync 物件上呼叫 RegisterServiceRoutine 方法，以便將迷你埠驅動程式的中斷服務例程（ISR）新增至中斷同步例程清單。當配接器驅動程式稍後釋放埠物件時，通訊埠驅動程序會釋放其 IInterruptSync 物件的 參考。

UnknownAdapter 和 ResourceList 參數是適配卡驅動程式先前傳遞為參數給 IPortMidi 物件的 Init 方法的指標值（請參閱 IPort：：Init）。

UnknownAdapter、ResourceList、Port和 ServiceGroup 參數遵循 COM 物件的參考計數慣例。