IPortDMus::RegisterServiceGroup 方法 (dmusicks.h)

方法 RegisterServiceGroup 會向 DMus 埠驅動程式註冊服務群組。

語法

void RegisterServiceGroup(
  [in] PSERVICEGROUP ServiceGroup
);

參數

[in] ServiceGroup

IServiceGroup 物件的指標。 這是要註冊的服務群組。

傳回值

備註

迷你埠驅動程式會呼叫 RegisterServiceGroup 方法來向埠驅動程序註冊 IServiceGroup 物件 (IServiceGroup 物件) 。 埠驅動程式可以將一或多個服務接收插入 (IServiceSink 物件) 至此服務群組。 迷你埠驅動程式會在每次發生中斷時呼叫 IPortDMus::Notify) 至服務群組,以傳送通知 (。 收到通知時,服務群組會排程延遲過程調用, (DPC) 。 DPC 會逐一查看服務群組中的所有服務接收,並傳送通知給每個接收。

迷你埠驅動程式通常會在執行其 IMiniportDMus::Init 方法期間呼叫 RegisterServiceSink。 此呼叫的目的是要儘早向埠驅動程式註冊服務群組,以便在啟用中斷時立即開始處理中斷。 請注意,在從 Init 方法傳回之後,Init 方法輸出的服務群組無法供埠驅動程式使用。

如果迷你埠驅動程式呼叫 RegisterServiceSink,迷你埠驅動程序傳遞給 RegisterServiceSink 方法的服務群組應該與迷你埠驅動程式透過其 Init 方法輸出的服務群組相同。

一般迷你埠驅動程式不需要再呼叫 RegisterServiceSinkIMiniportDMus::Init 傳回之後。

如需程式代碼範例,請參閱 Microsoft Windows 驅動程式套件中的 DMusUART 範例音訊驅動程式 (WDK) ,其中顯示迷你埠驅動程式如何從其 IMiniportDMus::Init 方法內呼叫RegisterServiceSink

pServiceGroup 參數遵循 COM 對象的參考計數慣例

規格需求

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

另請參閱

IMiniportDMus::Init

IPortDMus

IPortDMus::Notify

IServiceGroup

IServiceSink