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 存取。 在任何其他狀態中，驅動程式必須快取任何嘗試的硬體存取，並延遲這些存取，直到 還原 PowerDeviceD0 狀態為止。

如需詳細資訊，請參閱 音訊裝置的電源管理。

規格需求

另請參閱

DEVICE_OBJECT