IWiaMiniDrvTransferCallback::GetNextStream method (wiamindr_lh.h)

Called by the WIA mini-driver to obtain a stream for the current data transfer (download or upload).

Syntax

HRESULT GetNextStream(
  [in]  LONG    lFlags,
  [in]  BSTR    bstrItemName,
  [in]  BSTR    bstrFullItemName,
  [out] IStream **ppIStream
);

Parameters

[in] lFlags

Represents flag bits. This parameter is unused and should always be set to zero (0) by the caller.

[in] bstrItemName

The name of the item that will perform the data transfer.

For more information, see WIA_IPA_ITEM_NAME.

[in] bstrFullItemName

The full name of the item that will perform the data transfer.

For more information, see WIA_IPA_FULL_ITEM_NAME.

[out] ppIStream

A pointer to an IStream object.

Return value

This method returns S_OK when the call is successful. Otherwise it returns an appropriate HRESULT error code.

Remarks

When the client requests to skip the data transfer, the GetNextStream method returns WIA_STATUS_SKIP_ITEM. The WIA mini-driver must skip the current image transfer and continue with the next image transfer, if any. For example, for a download transfer, finish scanning the current image and then discard the image data.

When the current transfer sequence is cancelled, the GetNextStream method returns S_FALSE.

Requirements

Requirement Value
Minimum supported client Windows 8
Target Platform Desktop
Header wiamindr_lh.h

See also

Cancellation of Data Transfers

Data Transfer Between Legacy Application and Windows Driver

IWiaMiniDrvTransferCallback

WIA_IPA_FULL_ITEM_NAME

WIA_IPA_ITEM_NAME