IPortWavePci::Notify メソッド (portcls.h)

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

メソッドは Notify 、DMA ポインターの進行状況を示す割り込みが発生したことをポートドライバーに通知します。

構文

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

パラメーター

[in] ServiceGroup

ミニポートドライバーの IServiceGroup オブジェクトへのポインター。

戻り値

なし

解説

一部のミニポートドライバーは、割り込みソースをクリアした後、ハードウェア割り込みに応答して ISR からこのメソッドを呼び出します。他のドライバーは、定期的に実行するようにスケジュールされているタイマー DPC からこのメソッドを呼び出します。一般的な規則として、KMixer から 1 つのレンダリングストリームを管理するドライバーのみがハードウェア割り込みに依存する必要があります。 DirectSound ハードウェアアクセラレーションをサポートするドライバーでは、ハードウェア割り込みをオフにし、代わりにタイマー DPC を使用する必要があります。詳細については、「 IPortWavePciStream::GetMapping」を参照してください。

ミニポートドライバーは、このメソッドを呼び出すタイミングを決定するための独自の手法を自由に選択できますが、このメソッドは、ポートドライバーが一定の間隔で保留中の位置とクロックイベントを発生させるのに十分な頻度で呼び出す必要があります。ただし、このメソッドのタイミングは、IPortWaveCyclic::Notify メソッドほど重要ではありません。

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

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