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

콜백 상태 메시지를 지정하는 상수 값을 지정합니다. 이 값은 콜백의 용도를 결정하는 데 사용되며 다음 값 중 하나일 수 있습니다.

[in] lStatus

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

[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 동일하게 처리되어야 합니다. 드라이버가 이 메시지를 지원하는 경우 파일 전송 중에 미리 보기 데이터를 제공할 수 있습니다.

요구 사항

추가 정보

IWiaMiniDrvCallBack

MINIDRV_TRANSFER_CONTEXT