IAdapterPowerManagement::P owerChangeState メソッド (portcls.h)

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

メソッドは PowerChangeState 、デバイスが新しい電源状態に変更するように要求します。

構文

void PowerChangeState(
  [in] POWER_STATE NewState
);

パラメーター

[in] NewState

デバイスに対して要求される新しい電源状態を指定します。このパラメーターは、POWER_STATE型の共用体です。新しい電源状態 (NewState。DeviceState) には、次の表に示す DEVICE_POWER_STATE 列挙値のいずれかを指定できます。

電源状態	意味
PowerDeviceD0	完全な電源状態 (D0)。このコードは、現在の電源状態の関数である可能性があります。新しい状態を保存します。このローカル値は、プロパティアクセスをキャッシュするタイミングと、ドライバーがハードウェアへのアクセスを許可するタイミングを決定するために使用されます。
PowerDeviceD1	D0 に戻るために必要な待機時間に関して最も短い待機時間を持つスリープ状態
PowerDeviceD2	中程度の待機時間のスリープ状態。この状態では、デバイスドライバーはハードウェアに触れることができると想定できないため、アクセスをキャッシュし、D0 を入力したときにハードウェアを復元する必要があります。
PowerDeviceD3	完全な休止状態であり、最も長い待機時間のスリープ状態です。ドライバーは、この状態のハードウェアにアクセスできず、ハードウェアアクセスをキャッシュし、D0 または D1 に戻るとハードウェアを復元する必要があります

戻り値

なし

解説

PortCls は、PowerChangeStateIRP_MN_SET_POWER電源 IRP に応答してメソッドを呼び出します。この呼び出しは失敗してはなりません。 PortCls とシステムは、呼び出しを PowerChangeState 使用して、デバイスを目的の電源状態にします。システムがアクティブなオーディオストリームを中断または再開しようとすると、ドライバーはデバイスコンテキストを適切に保存または復元できる必要があります。

ドライバーを支援するために、PortCls は、このメソッドを呼び出してデバイスをスリープ状態にする前に、アクティブなオーディオストリームを一時停止します。このメソッドを呼び出すと、PortCls はアクティブなオーディオストリームの一時停止を解除してデバイスをスリープ解除します。ミニポートは、 IPowerNotify インターフェイスを利用して追加の通知を選択できます。

ミニポートドライバーは、呼び出しから返される前に、デバイスの電源状態に要求された変更を実行する PowerChangeState 必要があります。ミニポートドライバーが電源状態の変更の前にデバイスの状態を保存または復元する必要がある場合、ミニポートドライバーは IPowerNotify インターフェイスをサポートする必要があります。これにより、このような変更の事前警告を受け取ることができます。正常 PowerChangeState な呼び出しから戻る前に、ミニポートドライバーは新しい電源状態をキャッシュする必要があります。

ミニポートドライバーはスリープ状態 (PowerDeviceD0 以外の状態) のいずれかにありますが、ハードウェアへの書き込みを避ける必要があります。ミニポートドライバーは、デバイスの電源が再び起動するまで遅延する必要があるハードウェアアクセスをキャッシュする必要があります。電源状態がスリープ状態の 1 つから PowerDeviceD0 に変更されている場合、ミニポートドライバーは、デバイスの電源を入れた後、遅延ハードウェアアクセスを実行する必要があります。電源状態が PowerDeviceD0 からスリープ状態に変化している場合、ミニポートドライバーは、デバイスの電源を切る前に、呼び出し中に PowerChangeState 必要なハードウェアアクセスを実行できます。

電源を切っている間、ミニポートドライバーは、ミニポートドライバーオブジェクトまたはストリームオブジェクトを作成するように求められることはありません。 PortCls は、ミニポートドライバーの NewStream メソッドを呼び出す前に、常にデバイスを PowerDeviceD0 状態にします。

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