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

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

Notifyハードウェア割り込みが発生したときに、ミニポートドライバーの割り込みサービスルーチン (ISR) からメソッドを呼び出す必要があります。この呼び出しは、ミニポートドライバーが割り込みを処理している間、ポートドライバーが遅延プロシージャ呼び出し (DPC) でミニポートドライバーを呼び出すように要求します。

構文

void Notify(
  [in, optional] PSERVICEGROUP ServiceGroup
);

パラメーター

[in, optional] ServiceGroup

IServiceGroup オブジェクトへのポインター。このパラメーターは省略可能であり、 NULL として指定できます。詳細については、「解説」を参照してください。

戻り値

なし

解説

メソッドは Notify 、ミニポートドライバーのサービスグループに通知を送信します。

pServiceGroup パラメーターが NULL 以外の場合、Notifyこのパラメーターが指す IServiceGroup オブジェクトに対して RequestService メソッドが呼び出されます。
pServiceGroup が NULL の場合:
- メソッドは Notify 、ミニポートドライバーの IServiceGroup オブジェクトの RequestService メソッドを 呼び出します。これは、IMiniportDMus::Init 呼び出し中にミニポートドライバーが出力する IServiceGroup オブジェクトです。ミニポートドライバーは、IPortDMus::RegisterServiceGroup を呼び出すことによって、このオブジェクトを早期 (つまり、Init からの戻り値より前) に登録している場合もあります。
- メソッドはNotify、各ミニポートドライバーのストリームに属する IServiceGroup オブジェクトの RequestService メソッドも呼び出します。これは、IMiniportDMus::NewStream メソッドが出力する IServiceGroup オブジェクトです。

ミニポートドライバーは通常、オーディオデバイスがハードウェア割り込みを生成したことをポートドライバーに通知するためにを呼び出 Notify します。割り込みシグナル (たとえば、一部のレジスタを読み取る必要がある場合) は、ミニポートドライバーの ISR は昇格された IRQL で MXF (MIDI 変換フィルター) グラフにアクセスできません。代わりに、ミニポートドライバーは、レジスタから入力データ (MIDI データのバイトなど) を格納し、を呼び出 Notifyして、ポートドライバーが DPC で戻ってくるのを待つことができます。

ミニポートドライバーの ISR が呼び出 Notifyされると、ポートドライバーは管理者特権のハードウェア割り込み IRQL で通知を受け取り、DPC をキューに配置します。 IRQL がDISPATCH_LEVELにドロップすると、ポートドライバーの DPC が起動し、ミニポートドライバーにサービスを提供します。

DPC 内では、ポートドライバーは、ミニポートドライバーの入力ストリームで IMXF::P utMessage を呼び出し、 パラメーターが NULL の場合、IRQL がDISPATCH_LEVELに戻ったため、ミニポートドライバーが以前に保存した MIDI メッセージを MXF グラフに配置できることを示します。

この方法は、正確なタイミングに不可欠です。ほとんどのミニポートは、割り込みソースをクリアした後、通知割り込みに応答してこのメソッドを呼び出します。ミニポートドライバーは、このメソッドを呼び出すタイミングを決定するために他のメソッドを自由に使用できますが、正確なタイミングは重要であり、維持する必要があります。

アダプタードライバーは、ISR をインストールすると、ISR のエントリポイントと共に ServiceContext パラメーターを送信します (詳細については、「 ISR コンテキスト情報の提供」を参照してください)。割り込みが発生すると、オペレーティングシステムは ISR を呼び出し、呼び出しパラメーターとして ServiceContext を ISR に渡します。 ServiceContext パラメーターの意味はドライバー開発者にのみ知られていますが、通常はミニポートオブジェクトへのポインターです。 ISR は、このポインターを使用して、ミニポートオブジェクトに関する情報にアクセスします。

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