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

[アーティクル]
03/05/2024

メソッドは Notify 、DMA ポインターの進行状況を示す割り込みが発生したことをポートドライバーに通知します。ミニポートドライバーの割り込みサービスルーチン (ISR) から呼び出す必要があります。

構文

void Notify(
  [in] PSERVICEGROUP ServiceGroup
);

パラメーター

[in] ServiceGroup

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

戻り値

なし

解説

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

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

ポートドライバーは、IMiniportWaveCyclicStream::SetNotificationFreq メソッドを呼び出して、ISR がメソッドを呼び出す頻度を Notify 指定します。現在のすべての Windows リリースでは、ポートドライバーは連続する通知の間隔を 10 ミリ秒で指定します。この値は、将来のリリースで変更される可能性があります。

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