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 方法輸出的服務群組相同。
一般迷你埠驅動程式不需要再呼叫 RegisterServiceSink
IMiniportDMus::Init 傳回之後。
如需程式代碼範例,請參閱 Microsoft Windows 驅動程式套件中的 DMusUART 範例音訊驅動程式 (WDK) ,其中顯示迷你埠驅動程式如何從其 IMiniportDMus::Init 方法內呼叫RegisterServiceSink
。
pServiceGroup 參數遵循 COM 對象的參考計數慣例。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dmusicks.h (包含 Dmusicks.h) |
IRQL | PASSIVE_LEVEL |