PcRequestNewPowerState 函式 （portcls.h）
PcRequestNewPowerState 函式可用來要求裝置的新電源狀態。 適配卡驅動程式通常不需要此函式，但偶爾有助於解決某些硬體問題。
語法
PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
[in] PDEVICE_OBJECT pDeviceObject,
[in] DEVICE_POWER_STATE RequestedNewState
);
參數
[in] pDeviceObject
配卡 功能裝置物件的指標 （FDO）。 此參數必須指向類型為 DEVICE_OBJECT的系統結構。
[in] RequestedNewState
指定要要求的裝置電源狀態。 將此參數設定為下列其中一個 DEVICE_POWER_STATE 列舉值：PowerDeviceD0、PowerDeviceD1、PowerDeviceD2或 PowerDeviceD3。
傳回值
PcRequestNewPowerState 如果呼叫成功，就會傳回STATUS_SUCCESS。 否則，會傳回適當的錯誤訊息。
言論
配接器驅動程式可以呼叫 PcRequestNewPowerState 來補償硬體設計缺陷。 例如，如果音訊配接器中的函式不是相互獨立的，而且需要以特定順序關閉，配接器可以呼叫 PcRequestNewPowerState，以確保先關閉特定的子裝置。
RequestedNewState 參數可以設定為下表中的其中一個 DEVICE_POWER_STATE 列舉值。
| 電源狀態 | 意義 |
|---|---|
| PowerDeviceD0 | 完整電源狀態 |
| PowerDeviceD1 | 具有最低電源啟動延遲的睡眠狀態 |
| PowerDeviceD2 | 中等延遲睡眠狀態 |
| PowerDeviceD3 | 具有最長電源啟動延遲的完整休眠狀態和睡眠狀態 |
硬體只能在電源狀態 PowerDeviceD0存取。 在任何其他狀態下，驅動程式必須快取任何嘗試的硬體存取，並延遲這些存取，直到還原 PowerDeviceD0 狀態為止。
如需詳細資訊，請參閱 音訊裝置的電源管理。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的作系統中實作 PcRequestNewPowerState 函式。 |
| 目標平臺 | 普遍 |
| 標頭 | portcls.h （包括 Portcls.h） |
| 連結庫 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |