IStillImageW::GetSTILaunchInformation 方法 (sti.h)
IStillImage::GetSTILaunchInformation 方法返回调用静止图像应用程序启动的原因(如果仍为图像事件监视器启动它)。
语法
HRESULT GetSTILaunchInformation(
[out] LPWSTR pwszDeviceName,
[out, optional] DWORD *pdwEventCode,
[out] LPWSTR pwszEventName
);
参数
[out] pwszDeviceName
调用方提供的指向缓冲区的指针(长度STI_MAX_INTERNAL_NAME_LENGTH字节),以接收应用程序启动的静止映像设备的内部设备名称。
[out, optional] pdwEventCode
保留以供将来使用。
[out] pwszEventName
调用方提供的指向足以接收 GUID 字符串表示形式的缓冲区的调用方指针。 GUID 表示启动应用程序的 静止图像设备事件。
返回值
如果作成功,该方法将返回S_OK。 否则,它将返回在 stierr.h中定义的 STIERR 前缀错误代码之一。
言论
如果静止图像事件监视器启动应用程序,pwszDeviceName 和 pwszEventName 值标识 /StiDevice 和 /StiEvent 命令行参数(请参阅 IStillImage::RegisterLaunchApplication的说明)。 如果事件监视器未启动应用程序,该方法将返回STIERR_GENERIC。
在调用 IStillImage::GetSTILaunchInformation之前,IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | sti.h (include Sti.h) |