Метод IWiaTransferCallback::GetNextStream (wia_lh.h)
Метод IWiaTransferCallback::GetNextStream реализуется фильтром обработки изображений. Она вызывается службой WIA в результате вызова приложения IWiaTransfer::D ownload или компонента предварительной версии IWiaPreview::GetNewPreview](/windows/win32/wia/-wia-iwiapreview-getnewpreview).
Синтаксис
HRESULT GetNextStream(
[in] LONG lFlags,
[in] BSTR bstrItemName,
[in] BSTR bstrFullItemName,
[out] IStream **ppDestination
);
Параметры
[in] lFlags
Зарезервировано, присвойте нулю.
[in] bstrItemName
Указывает строку, содержащую имя элемента.
[in] bstrFullItemName
Указывает строку, содержащую полное имя элемента.
[out] ppDestination
Указывает указатель на выходной поток.
Возвращаемое значение
Возвращает S_OK в случае успешного выполнения или стандартного значения ошибки COM в противном случае.
Замечания
Реализация фильтра обработки изображений IWiaTransferCallback::GetNextStream и IWiaTransferCallback::TransferCallback вызываются во время приобретения образа, когда мини-драйвер WIA запрашивает целевой поток от клиента и когда мини-драйвер отправляет сообщения о ходе выполнения в приложение.
Реализация фильтра обработки изображений IWiaTransferCallback::GetNextStream должна делегировать метода IWiaTransferCallback::GetNextStream. Затем фильтр обработки изображений использует поток, возвращаемый обратного вызова приложения IWiaTransferCallback::GetNextStream, чтобы создать собственный поток (поток фильтрации), который он передает обратно в службу WIA.
В своей реализации IWiaTransferCallback::GetNextStream фильтр обработки изображений должен считывать свойства, необходимые для обработки изображений из элемента, для которого получается изображение. Фильтр не должен считывать свойства непосредственно из pWiaItem2 передан в IWiaImageFilter::InitializeFilter; вместо этого необходимо вызвать IWiaItem2::FindItemByName](/windows/win32/wia/-wia-iwiaitem2-finditembyname) на этом элементе WIA, чтобы получить фактический элемент WIA. Причина заключается в том, что во время передачи папок полученные изображения соответствуют дочерним элементам pWiaItem2 вместо того, чтобы pWiaItem2 себя.
Этот метод не вызывается компонентом предварительной версии во время IWiaPreview::UpdatePreview.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | wia_lh.h (include Wia_lh.h) |