iPhotoAcquire：：Acquire 方法 (photoacquire.h)

  • 项目

方法 Acquire 从设备获取照片。

语法

HRESULT Acquire(
  [in] IPhotoAcquireSource     *pPhotoAcquireSource,
  [in] BOOL                    fShowProgress,
  [in] HWND                    hWndParent,
  [in] LPCWSTR                 pszApplicationName,
  [in] IPhotoAcquireProgressCB *pPhotoAcquireProgressCB
);

参数

[in] pPhotoAcquireSource

指向 IPhotoAcquireSource 对象的指针，该对象表示要从中获取照片的设备。 通过调用 CreatePhotoSource 初始化此对象。

[in] fShowProgress

当设置为 TRUE 时，指示将显示进度对话框的标志。

[in] hWndParent

父窗口的句柄。

[in] pszApplicationName

指向包含应用程序名称的以 null 结尾的字符串的指针。

[in] pPhotoAcquireProgressCB

指向可选 IPhotoAcquireProgressCB 对象的指针。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码 说明
S_OK
 方法成功。
E_POINTER
 预期为非 NULL 指针。

注解

若要初始化传递给 Acquire的 pPhotoAcquireSource 参数，应在调用 Acquire之前调用 CreatePhotoSource。

pPhotoAcquireProgressCB 提供回调方法，可用于在获取项目时应用进一步筛选或控制。

若要在获取之前验证设备中是否存在项，或者要有选择地从设备获取项，请在调用 Acquire之前调用 IPhotoAcquireSource：：InitializeItemList 以枚举项。

要求

要求 值
目标平台 Windows
标头 photoacquire.h
Library PhotoAcquireUID.lib

另请参阅

IPhotoAcquire 接口

IPhotoAcquireProgressCB 接口

IPhotoAcquireSource 接口