IStillImageW::EnableHwNotifications 方法 (sti.h)

IStillImage::EnableHwNotifications 方法请求静态图像事件监视器,以便在指定设备发生静态图像设备事件时启用或禁用应用程序的通知。

语法

HRESULT EnableHwNotifications(
  [in] LPCWSTR pwszDeviceName,
       BOOL    bNewState
);

参数

[in] pwszDeviceName

调用方提供的指向表示内部设备名称的字符串的指针,通过调用 IStillImage::GetSTILaunchInformationIStillImage::GetDeviceList 获取。

bNewState

调用方提供的值,设置为 TRUE 以启用通知, 将 FALSE 设置为禁用通知。

返回值

如果操作成功,该方法将返回S_OK。 否则,它将返回 stierr.h 中定义的 STIERR 前缀错误代码之一。

注解

IStillImage::EnableHwNotifications 方法为所有应用程序(而不仅仅是调用应用程序)启用或禁用静态图像设备事件的通知。 默认情况下,事件通知处于启用状态。 此方法适用于截获来自设备的事件并重新路由它们的应用程序。

在调用 IStillImage::EnableHwNotifications 之前, IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。

要求

要求
目标平台 桌面
标头 sti.h (包括 Sti.h)

另请参阅

IStillImage::LaunchApplicationForDevice

IStillImageW