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 포함) |