Метод IWiaMiniDrvCallBack::MiniDrvCallback (wiamindr_lh.h)

Статья
02/07/2025

Метод MiniDrvCallback предоставляет метод обратного вызова для мини-drivers WIA для использования во время передачи данных обратного вызова.

Синтаксис

HRESULT MiniDrvCallback(
  [in] LONG                      lReason,
  [in] LONG                      lStatus,
  [in] LONG                      lPercentComplete,
  [in] LONG                      lOffset,
  [in] LONG                      lLength,
  [in] PMINIDRV_TRANSFER_CONTEXT pTranCtx,
  [in] LONG                      lReserved
);

Параметры

[in] lReason

Указывает константное значение, указывающее сообщение о состоянии обратного вызова. Это значение используется для определения назначения обратного вызова и может быть одним из следующих значений:

Сообщение	Определение
IT_MSG_DATA	Указывает, что буфер передачи содержит блок данных.
IT_MSG_DATA_HEADER	Получено до передачи данных. Указывает, что буфер передачи указывает на структуру WIA_DATA_CALLBACK_HEADER, которая определяет элементы передачи данных.
IT_MSG_DEVICE_STATUS	Обратный вызов содержит только сведения о состоянии устройства.
IT_MSG_FILE_PREVIEW_DATA	Указывает, что данные предварительной версии передаются в приложение.
IT_MSG_FILE_PREVIEW_DATA_HEADER	Указывает, что заголовок передается приложению до передачи предварительных данных.
IT_MSG_NEW_PAGE	Указывает, что передача данных страницы завершена, и отправляется новая страница.
IT_MSG_STATUS	Обратный вызов содержит только сведения о состоянии передачи.
IT_MSG_TERMINATION	Указывает, что передача данных завершена.

[in] lStatus

Указывает состояние передачи. Этот параметр является битовой или из следующих значений:

Статус	Определение
IT_STATUS_TRANSFER_FROM_DEVICE	Передача данных с устройства.
IT_STATUS_PROCESSING_DATA	Устройство и (или) мини-driver обрабатывают данные.
IT_STATUS_TRANSFER_TO_CLIENT	Передача данных из мини-driver в службу WIA.

[in] lPercentComplete

Указывает текущий процент передаваемых данных.

[in] lOffset

Указывает текущее смещение (в байтах) в буфер передачи с начала буфера.

[in] lLength

Указывает количество байтов, содержащихся в передаче.

[in] pTranCtx

Указывает на структуру MINIDRV_TRANSFER_CONTEXT, содержащую значения передачи данных.

[in] lReserved

Скрытный. Установите значение нулю.

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

Если метод выполнен успешно, он возвращает S_OK. Если обратный вызов отменен клиентским приложением, метод возвращает S_FALSE. Если метод завершается ошибкой, он возвращает стандартный код ошибки COM.

Замечания

Процент завершенных значений отправляется непосредственно из драйвера. Служба WIA не настраивает значения.

IT_MSG_FILE_PREVIEW_DATA_HEADER используется для внеполосных данных. Это позволяет приложению выполнять передачу файлов для отображения смещенных данных. Это полезно для сканеров прокрутки с неизвестной длиной и без предварительного просмотра сканирования. Сведения, сообщаемые в этом сообщении, должны рассматриваться так же, как и IT_MSG_DATA_HEADER. Если драйвер поддерживает это сообщение, он может предоставить предварительные данные во время передачи файлов.

Требования

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

См. также

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT

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