IWiaMiniDrvCallBack::MiniDrvCallback 메서드(wiamindr_lh.h)

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

전송 상태를 지정합니다. 이 매개 변수는 다음 값의 비트 OR입니다.

상태	정의
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

예약되어 있습니다. 0으로 설정됩니다.

반환 값

메서드가 성공하면 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