RegisterServiceGroup メソッドは、DMus ポート ドライバーにサービス グループを登録します。
構文
void RegisterServiceGroup(
[in] PSERVICEGROUP ServiceGroup
);
パラメーター
[in] ServiceGroup
IServiceGroup オブジェクトへのポインター。 これは、登録するサービス グループです。
戻り値
何一つ
備考
ミニポート ドライバーは、ポート ドライバーにサービス グループ (RegisterServiceGroup オブジェクト) を登録する メソッドを呼び出します。 ポート ドライバーは、1 つ以上のサービス シンク (IServiceSink オブジェクト) をこのサービス グループに挿入できます。 ミニポート ドライバーは、割り込みが発生するたびにサービス グループに (IPortDMus::Notifyを呼び出すことによって) 通知を送信します。 通知を受信すると、サービス グループは遅延プロシージャ コール (DPC) をスケジュールします。 DPC は、サービス グループ内のすべてのサービス シンクを反復処理し、それぞれに通知を送信します。
ミニポート ドライバーは通常、IMiniportDMus::Init メソッドの実行中に registerServiceSink を呼び出します。 この呼び出しの目的は、割り込みが有効になるとすぐに処理を開始するのに十分な早い段階でポート ドライバーにサービス グループを登録することです。 Init メソッドが出力するサービス グループは、Init メソッドから戻るまでポート ドライバーで使用できません。
ミニポート ドライバーが RegisterServiceSinkを呼び出す場合、ミニポート ドライバーが RegisterServiceSink メソッドに渡すサービス グループは、ミニポート ドライバーが Init メソッドを介して出力するのと同じである必要があります。
一般的なミニポート ドライバーは、RegisterServiceSink からのリターンが発生した後、 を呼び出す必要はありません。
ミニポート ドライバーが RegisterServiceSink メソッド内から を呼び出す方法を示すコード例については、Microsoft Windows Driver Kit (WDK) の DMusUART サンプル オーディオ ドライバーを参照してください。
pServiceGroup パラメーターは、COM オブジェクトの 参照カウント規則に従います。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | dmusicks.h (Dmusicks.h を含む) |
| IRQL | PASSIVE_LEVEL |
関連項目
IPortDMus を する
IServiceGroup の
IServiceSink の