IPowerNotify::P owerChangeNotify メソッド (portcls.h)
メソッドは PowerChangeNotify 、ミニポート ドライバーに電源状態の変更を通知します。
構文
void PowerChangeNotify(
[in] POWER_STATE PowerState
);
パラメーター
[in] PowerState
現在の電源状態を指定します。 このパラメーターは、POWER_STATE型の共用体です。 新しい電源状態 (PowerState。DeviceState) には、 IAdapterPowerManagement::P owerChangeState に記載されているDEVICE_POWER_STATE列挙値のいずれかを指定できます。
戻り値
なし
解説
PortCls システム ドライバーは、ミニポート ドライバーの PowerChangeNotify メソッドを呼び出して、電源状態の変化を通知します。 この呼び出しの目的は、ミニポート ドライバーに電源を切る直前にハードウェア固有のコンテキストを保存する機会を与えるか、電源を入れた直後に以前に保存されたコンテキストを復元することです。
ミニポート ドライバーは、呼び出し中 PowerChangeNotify にハードウェア レジスタまたはオンボード メモリに書き込むことができます。 システムの電源が切れている (PowerDeviceD0 から状態遷移が行われる) 場合、PortCls システム ドライバーは、IAdapterPowerManagement::P owerChangeState を呼び出す前に、アクティブなオーディオ データ ストリームを一時停止した後に を呼び出PowerChangeNotifyします。 これにより、デバイスの電源が切れる前に、ミニポート ドライバーにハードウェア固有のデバイス コンテキストを保存する機会が与えられます。 たとえば、WavePci ミニポート ドライバーは、データ転送の散在または収集のシーケンス中に電源ダウンが発生した場合、DMA レジスタを保存する必要があります。 システムが電源を入れている場合 (PowerDeviceD0 への状態遷移を行う)、PortCls は PowerChangeState を呼び出した後、一時停止しているオーディオ データ ストリームを再起動する前に を呼び出PowerChangeNotifyします。 これにより、ミニポート ドライバーは、デバイスの電源が入った後、以前に保存されたコンテキストを復元する機会を与えます。
このメソッドのコードは、ページ メモリ内に存在する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | portcls.h (Portcls.h を含む) |