IAMExtDevice：：get_DevicePower 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

方法 get_DevicePower 检索外部设备的电源模式。

语法

HRESULT get_DevicePower(
  [out] long *pPowerMode
);

参数

[out] pPowerMode

指向一个 长 整数的指针，该整数接收以下值之一，指示设备的电源模式。

值	说明
ED_POWER_OFF	电源已关闭。
ED_POWER_ON	如果打开，则为电源。
ED_POWER_STANDBY	设备处于待机模式。

返回值

此方法成功后，将返回S_OK。 否则，它将返回 HRESULT 错误代码。

备注

在 Windows XP Service Pack 2 及更高版本中，定义了以下附加电源模式。

值	说明
ED_POWER_DEVICE_DEPENDENT	电源已打开，功能有限。

 

若要使用此常量，请包含头文件 Xprtdefs.h。

DV 和 MPEG 摄像机实现

打开摄像机时， 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)
Library	Strmiids.lib

另请参阅

错误和成功代码

IAMExtDevice 接口

IAMExtDevice：:p ut_DevicePower