Метод IWiaTransferCallback::GetNextStream (wia_lh.h)

Метод IWiaTransferCallback::GetNextStream реализуется фильтром обработки изображений. Он вызывается службой WIA в результате вызова приложения IWiaTransfer::D ownload или предварительного просмотра компонента 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 в этом элементе WIA, чтобы получить фактический элемент WIA. Причина заключается в том, что во время передачи папок полученные изображения соответствуют дочерним элементам pWiaItem2 вместо того, чтобы pWiaItem2 себя.

Этот метод не вызывается компонентом предварительной версии во время IWiaPreview::UpdatePreview.

Требования

См. также

IWiaImageFilter::InitializeFilter

IWiaTransferCallback