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

Статья
02/07/2025

Метод IWiaTransferCallback::TransferCallback реализуется фильтром обработки изображений. Она вызывается службой WIA в результате вызова приложения IWiaTransfer::D ownload или компонента предварительной версии IWiaPreview::GetNewPreview.

Синтаксис

HRESULT TransferCallback(
  [in] LONG              lFlags,
  [in] WiaTransferParams *pWiaTransferParams
);

Параметры

[in] lFlags

В настоящее время не используется. Должно быть задано равно нулю.

[in] pWiaTransferParams

Указывает указатель на структуру WiaTransferParams.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения или стандартного значения ошибки COM в противном случае.

Замечания

Реализация фильтра обработки изображений метод IWiaTransferCallback::TransferCallback вызывается во время приобретения изображения, когда мини-драйвер WIA запрашивает целевой поток от клиента и когда мини-драйвер отправляет сообщения о ходе выполнения обратно в приложение.

Метод фильтра обработки изображений IWiaTransferCallback::TransferCallback должен делегировать методу обратного вызова приложения IWiaTransferCallback::TransferCallback. Во многих случаях реализация фильтра обработки изображений IWiaTransferCallback::TransferCallback также потребуется изменить ulBytesWrittenToCurrentStream и, возможно, lPercentComplete значения в структуре WiaTransferParams. ulBytesWrittenToCurrentStream необходимо изменить, если фильтр обработки изображений должен буферизовывать данные изображения между вызовами метода записи, прежде чем записывать данные в предоставленный приложением поток. Это, например, необходимо, если выполняется смена и (или) поворота. Если смена или управление рабочими столами не требуется, фильтр должен лучше работать над полосами данных. lPercentComplete не обязательно необходимо изменить, так как этот параметр указывает процент общего времени передачи. Этот элемент может использоваться индикатором выполнения в приложении. Обратите внимание, что фильтр обработки изображений не должен изменять элемент lMessage структуры. IWiaTransferCallback::TransferCallback также не должно "проглотить" какие-либо сообщения, которые он получает, даже если он выполняет буферизацию, а вместо этого следует изменить элемент ulBytesWrittenToCurrentStream.

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wia_lh.h (include Wia_lh.h)

Поделиться через