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 を呼び出します。 これにより、ミニポート ドライバーは、デバイスの電源が入った後、以前に保存されたコンテキストを復元する機会を与えます。

このメソッドのコードは、ページング されたメモリ内に存在する必要があります。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	portcls.h (Portcls.h を含む)

関連項目

IAdapterPowerManagement::P owerChangeState

IPowerNotify の