IPowerNotify インターフェイス (portcls.h)
インターフェイスは IPowerNotify
、ミニポート ドライバーが差し迫った電源状態の変更の事前通知を必要とする場合に公開できるオプションのインターフェイスです。 ミニポート ドライバーがインターフェイスをサポートIPowerNotify
しているかどうかを判断するために、ポート ドライバーは、REFIID IID_IPowerNotifyを使用してミニポート ドライバー オブジェクトの QueryInterface メソッドを呼び出します。 次のミニポート ドライバーの種類は、 をサポート IPowerNotify
できます。
IPowerNotify
は IUnknown インターフェイスから継承されます。
インターフェイスは IPowerNotify
、電源状態の変化が発生したときにミニポート ドライバーに通知するためにポート ドライバーが呼び出す 1 つのメソッドを提供します。
たとえば、オペレーティング システムがウェーブ オーディオ デバイスにスリープ状態に移行するように指示すると、ポート ドライバーはアクティブなストリームを一時停止し、電源通知コールバックを呼び出して、差し迫った電源ダウンをミニポート ドライバーに通知します。 その後、ミニポート ドライバーには、アダプターの PowerChangeState メソッドが呼び出される前に、必要なコンテキストを保存する機会があります。
デバイスの電源が入ると、プロセスは逆になります。 PortCls は、最初にアダプターの PowerChangeState メソッドを呼び出してアダプターの電源をオンにします。 その後、ポート ドライバーは、ミニポート ドライバーのコールバックを呼び出して、ミニポート ドライバーがコンテキストを復元できるようにします。 最後に、ポート ドライバーは、以前に一時停止したアクティブなオーディオ ストリームの一時停止を解除します。
詳細については、「 IPowerNotify の実装」を参照してください。
継承
IPowerNotify インターフェイスは、IUnknown インターフェイスから継承されます。 IPowerNotify には、次の種類のメンバーもあります。
メソッド
IPowerNotify インターフェイスには、これらのメソッドがあります。
IPowerNotify::P owerChangeNotify PowerChangeNotify メソッドは、ミニポート ドライバーに電源状態の変更を通知します。 |
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | portcls.h |