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