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

Статья
08/08/2023

Метод MiniDrvCallback предоставляет метод обратного вызова для мини-накопителей 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	Устройство и (или) мини-диск обрабатывают данные.
IT_STATUS_TRANSFER_TO_CLIENT	Передача данных из мини-драйвера в службу WIA.

[in] lPercentComplete

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

[in] lOffset

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

[in] lLength

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

[in] pTranCtx

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

[in] lReserved

Зарезервировано. Задайте нулевое значение.

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

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wiamindr_lh.h (включая Wiamindr.h)

См. также раздел

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT

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