割り込み同期のオブジェクト

PortCls システム ドライバーは、ミニポート ドライバーのメリットを活かすため、IInterruptSync インターフェイスを実装します。 IInterruptSync は、割り込みサービス ルーチン (ISR) の一覧の実行を非割り込みルーチンと同期する割り込み同期オブジェクトを表しています。

割り込み同期オブジェクトには、次の 2 つの主な機能があります。

• 割り込みに対する ISR の一覧の実行。 同期オブジェクトは、割り込みソースに接続されます。 割り込みが発生するたびに、同期オブジェクトは、選択したモードに従って指定された順序で ISR を実行します。 (3 つのモードについては、次の説明をご覧ください。)

• ISR ではないルーチンの実行。 これらの非割り込みルーチンは、同期オブジェクトの割り込みに接続されません。 代わりに、非割り込みルーチンは、呼び出し元の選択時点で実行されます。 ただし、同期オブジェクトは、オブジェクトの ISR の一覧を使用して非割り込みルーチンを同期的に実行します。 言い換えると、非割り込みルーチンは、同期オブジェクトの一覧の ISR が実行を開始する前に、完了するまで実行されます。その逆も同様です。

割り込み同期オブジェクトは、複数の ISR を柔軟に処理できます。 ISR は、同期オブジェクトが割り込み時に走査する、リンクされた一覧に存在します。 ミニポート ドライバーは、同期オブジェクトに ISR を登録するとき、ISR をこの一覧の先頭または末尾に追加するかどうかを指定します。

ミニポート ドライバーは、PcNewInterruptSync 関数を呼び出して、割り込み同期オブジェクトを作成します。 この呼び出し中、ドライバーは、オブジェクトが割り込み時に ISR の一覧を走査する方法を指定します。 この呼び出しでは、次の表の INTERRUPTSYNCMODE 列挙定数で指定された 3 つのオプションがサポートされています。

InterruptSyncModeNormal モードでは、同期オブジェクトは、ISR のいずれかが STATUS_SUCCESS を返すまで、一覧内の各 ISR を呼び出します。 この ISR に続く一覧の ISR が呼び出されることはありません。 このモードは、オペレーティング システムが通常 ISR を処理する方法をエミュレートします。 どの ISR も STATUS_SUCCESS を返さない場合、動作は InterruptSyncModeAll と同じです。

InterruptSyncModeAll モードでは、上記の ISR のリターン コードに関係なく、一覧内の各 ISR が 1 回だけ呼び出されます。 これは、割り込みのソースが決定論的ではないより原始的なハードウェアを対象としていますが、他の状況でも役立つ場合があります。 たとえば、特定の割り込みが 2 つのソースのうちどちらから発生しているかに関係なく、割り込みごとに 2 つの割り込みソースが緊密に同期される可能性があります。

InterruptSyncModeRepeat モードでは、同期オブジェクトは、一覧内のどのルーチンも STATUS_SUCCESS を返さない一覧のトリップが発生するまで、ISR の一覧全体を繰り返し走査します。 このモードは、複数のソースからの割り込みが同じ割り込みラインで同時に発生したり、ISR 処理中に 2 つ目の割り込みが発生したりする場合に適しています。 各割り込みソースは、処理が必要かどうかを判断できる必要があります。 常に STATUS_SUCCESS を返す ISR がこのモードで同期オブジェクトに登録されている場合、システムは応答を停止します。

これらのいずれかのモードで、登録された ISR のいずれかが STATUS_SUCCESS を返した場合、同期オブジェクトはオペレーティング システムへの割り込みを確認します。 3 つのモードすべてで、割り込みを正常に処理しなかったことをすべての割り込みソースが示している場合、同期オブジェクトは、失敗した結果コードをオペレーティング システムに返します。

IInterruptSync インターフェイスでは、次のメソッドがサポートされています。

IInterruptSync::CallSynchronizedRoutine

IInterruptSync::Connect

IInterruptSync::Disconnect

IInterruptSync::GetKInterrupt

IInterruptSync::RegisterServiceRoutine