IPhotoAcquire::CreatePhotoSource method (photoacquire.h)

The CreatePhotoSource method initializes an IPhotoAcquireSource object to pass to IPhotoAcquire::Acquire.

Syntax

HRESULT CreatePhotoSource(
  [in]  LPCWSTR             pszDevice,
  [out] IPhotoAcquireSource **ppPhotoAcquireSource
);

Parameters

[in] pszDevice

Pointer to a null-terminated string containing the device name.

[out] ppPhotoAcquireSource

Returns the initialized photo source to acquire photos from.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_POINTER
A non-NULL pointer was expected.

Remarks

The IPhotoAcquireSource object created is used as the parameter for the Acquire method.

If an error occurs in CreatePhotoSource, ppPhotoAcquireSource is initialized to NULL.

Requirements

Requirement Value
Target Platform Windows
Header photoacquire.h
Library PhotoAcquireUID.lib

See also

IPhotoAcquire Interface

IPhotoAcquire::Acquire