IMiniportDMus::Init 方法 (dmusicks.h)

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

語法

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

參數

[in, optional] UnknownAdapter

要初始化其迷你埠物件的配接器物件的 IUnknown 介面指標。 此參數是選擇性的,可以指定為 Null。 如需詳細資訊,請參閱接下來的<備註>一節。

[in] ResourceList

IResourceList物件的指標,其中包含配接器的資源清單。 將這個參考傳遞至迷你埠驅動程式之後,埠驅動程式即可免費檢查資源清單的內容,但不會修改此清單的內容。

[in] Port

提供埠驅動程式回呼介面的 IPortDMus 物件的指標。

[out] ServiceGroup

服務群組的輸出指標。 此參數指向呼叫端配置的指標變數,此方法會將指標寫入迷你埠驅動程式服務群組物件的 IServiceGroup 介面。 這是此迷你埠驅動程式想要用來呼叫 IPortDMus::Notify的服務群組。

傳回值

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

備註

pUnknownAdapter參數是選擇性的:

  • 如果 pUnknownAdapter 不是Null,此方法 Init 會查詢 pUnknownAdapter 物件的 IInterruptSync 介面。
  • 如果 pUnknownAdapterNull,此方法 Init 會呼叫 PcNewInterruptSync 來建立新的 IInterruptSync 物件。 在此情況下, pResourceList 指向的資源清單會提供新 IInterruptSync 物件所使用的中斷資源。
不論是哪一種情況, Init 方法都會在IInterruptSync物件上呼叫RegisterServiceRoutine方法,以便將 miniport 驅動程式的插斷服務常式新增至 ISR 清單 (ISR) 。 當配接器驅動程式稍後釋放埠物件時,埠驅動程式會釋放其 IInterruptSync 物件的參考。

pUnknownAdapterpResourceList參數與配接器驅動程式先前傳遞為參數的指標值相同, (請參閱IPortInit::Init) 。

pUnknownAdapterpResourceListpPortppServiceGroup參數會遵循COM 物件的參考計數慣例

規格需求

   
目標平臺 桌面
標頭 dmusicks.h (包含 Dmusicks.h)
IRQL PASSIVE_LEVEL

另請參閱

IInterruptSync

IMiniportDMus

IPort::Init

IPortDMus

IPortDMus::Notify

IResourceList

IServiceGroup

PcNewInterruptSync