IAMExtDevice：：get_DevicePower 方法 (strmif.h)
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
方法 get_DevicePower 會擷取外部裝置的電源模式。
語法
HRESULT get_DevicePower(
[out] long *pPowerMode
);
參數
[out] pPowerMode
接收下列其中一個值的 長 整數指標，表示裝置的電源模式。
| 值 | Description |
|---|---|
| ED_POWER_OFF | 電源已關閉。 |
| ED_POWER_ON | 開啟電源。 |
| ED_POWER_STANDBY | 裝置處於待命模式。 |
傳回值
當此方法成功時，它會傳回S_OK。 否則會傳回 HRESULT 錯誤碼。
備註
在 Windows XP Service Pack 2 和更新版本中，會定義下列額外的電源模式。
| 值 | Description |
|---|---|
| ED_POWER_DEVICE_DEPENDENT | 電源已開啟，但函式有限。 |
若要使用這個常數，請包含標頭檔 Xprtdefs.h。
DV 和 MPEG Camcorder 實作
當相機開啟時， MSDV 和 UVC 驅動程式會傳回ED_POWER_ON。 如果相機已關閉或處於待命模式，則不會載入 DV 驅動程式，因此無法使用此方法。 如果非預期地移除攝影機，方法可以傳回ERROR_GEN_FAILURE。MSTape 同時支援ED_POWER_OFF和ED_POWER_ON，但不支援ED_POWER_STANDBY。
規格需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | strmif.h (包含 Dshow.h) |
| 程式庫 | Strmiids.lib |