IPortDMus::RegisterServiceGroup メソッド (dmusicks.h)

[アーティクル]
08/07/2023

メソッドは RegisterServiceGroup 、DMus ポートドライバーにサービスグループを登録します。

構文

void RegisterServiceGroup(
  [in] PSERVICEGROUP ServiceGroup
);

パラメーター

[in] ServiceGroup

IServiceGroup オブジェクトへのポインター。これは、登録されるサービスグループです。

戻り値

なし

解説

ミニポートドライバーは、メソッドを RegisterServiceGroup 呼び出して、ポートドライバーにサービスグループ (IServiceGroup オブジェクト) を登録します。ポートドライバーは、1 つ以上のサービスシンク (IServiceSink オブジェクト) をこのサービスグループに挿入できます。ミニポートドライバーは、割り込みが発生するたびにサービスグループに ( IPortDMus::Notify を呼び出すことによって) 通知を送信します。通知を受信すると、サービスグループは遅延プロシージャ呼び出し (DPC) をスケジュールします。 DPC は、サービスグループ内のすべてのサービスシンクを反復処理し、それぞれに通知を送信します。

ミニポートドライバーは通常、IMiniportDMus::Init メソッドの実行中に RegisterServiceSink を呼び出します。この呼び出しの目的は、割り込みが有効になるとすぐに処理を開始するのに十分な早い段階でポートドライバーにサービスグループを登録することです。 Init メソッドが出力するサービスグループは、Init メソッドから戻るまでポートドライバーで使用できません。

ミニポートドライバーがを呼び出す RegisterServiceSink場合、ミニポートドライバーがメソッドに RegisterServiceSink 渡すサービスグループは、ミニポートドライバーが Init メソッドを介して出力するのと同じである必要があります。

一般的なミニポートドライバーは、IMiniportDMus::Init からの戻りが発生した後にを呼び出すRegisterServiceSink必要はありません。

ミニポートドライバーが IMiniportDMus::Init メソッド内からどのように呼び出RegisterServiceSinkされるかを示すコード例については、Microsoft Windows Driver Kit (WDK) の DMusUART サンプルオーディオドライバーを参照してください。

pServiceGroup パラメーターは、COM オブジェクトの参照カウント規則に従います。