PcRequestNewPowerState 関数 (portcls.h)

  • [アーティクル]

PcRequestNewPowerState 関数は、デバイスの新しい電源状態を要求するために使用されます。 この関数は、通常、アダプター ドライバーでは必要ありませんが、場合によっては、いくつかの種類のハードウェアの問題を回避するのに役立つことがあります。

構文

PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
  [in] PDEVICE_OBJECT     pDeviceObject,
  [in] DEVICE_POWER_STATE RequestedNewState
);

パラメーター

[in] pDeviceObject

アダプターの 機能デバイス オブジェクト (FDO) へのポインター。 このパラメーターは、 DEVICE_OBJECT型のシステム構造を指す必要があります。

[in] RequestedNewState

要求されるデバイスの電源状態を指定します。 このパラメーターを、PowerDeviceD0、PowerDeviceD1、PowerDeviceD2、または PowerDeviceD3 のいずれかのDEVICE_POWER_STATE列挙値に設定します。

戻り値

PcRequestNewPowerState は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切なエラー メッセージを返します。

注釈

アダプター ドライバーは 、PcRequestNewPowerState を呼び出して、ハードウェア設計の欠陥を補うことができます。 たとえば、オーディオ アダプター内の関数が相互に独立していない場合、特定の順序でシャットダウンする必要がある場合、アダプターは PcRequestNewPowerState を呼び出して、特定のサブデバイスが最初にシャットダウンされるようにすることができます。

RequestedNewState パラメーターは、次の表のDEVICE_POWER_STATE列挙値のいずれかに設定できます。

電源状態 意味
PowerDeviceD0 完全な電源状態
PowerDeviceD1 電源投入待機時間が最も短いスリープ状態
PowerDeviceD2 中待機時間のスリープ状態
PowerDeviceD3 完全な休止状態と、最長のパワーアップ待機時間を持つスリープ状態
 

ハードウェアには、 電源状態の PowerDeviceD0 でのみアクセスできます。 その他の状態では、ドライバーは、試行されたハードウェア アクセスをキャッシュし、 PowerDeviceD0 状態が復元されるまでそれらのアクセスを延期する必要があります。

詳細については、「 オーディオ デバイスの電源管理」を参照してください。

要件

要件 値
サポートされている最小のクライアント PortCls システム ドライバーは、Microsoft Windows 98/Me および Windows 2000 以降のオペレーティング システムで PcRequestNewPowerState 関数を実装します。
対象プラットフォーム ユニバーサル
Header portcls.h (Portcls.h を含む)
Library Portcls.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

DEVICE_OBJECT