wiasGetImageInformation 함수(wiamdef.h)
wiasGetImageInformation 함수는 항목에서 전송 컨텍스트 정보를 검색합니다.
구문
HRESULT wiasGetImageInformation(
[in] BYTE *pWiasContext,
LONG lFlags,
[in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);
매개 변수
[in] pWiasContext
WIA 항목 컨텍스트에 대한 포인터입니다.
lFlags
작업 플래그를 지정합니다. 현재 다음 플래그만 정의됩니다.
| 플래그 | 의미 |
|---|---|
| WIAS_INIT_CONTEXT | MINIDRV_TRANSFER_CONTEXT 구조를 초기화합니다. |
[in, out] pmdtc
MINIDRV_TRANSFER_CONTEXT 구조체에 대한 포인터입니다. 반환 시 이 구조체에는 요청된 이미지 항목 정보가 포함됩니다.
반환 값
성공하면 함수는 S_OK 반환합니다.
함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나가 반환됩니다.
설명
이 함수는 MINIDRV_TRANSFER_CONTEXT 구조를 사용하여 항목 이미지 및 항목 헤더 크기를 계산합니다. 또한 이미지 형식에 데이터 헤더가 필요한 경우 필요에 따라 이미지 헤더를 채울 수 있습니다. MINIDRV_TRANSFER_CONTEXT 구조체의 pTransferBuffer 멤버가 NULL이 아닌 경우 헤더가 버퍼에 복사됩니다. 헤더가 없는 이미지 형식(예: JPEG)을 사용하는 경우 MINIDRV_TRANSFER_CONTEXT 구조체의 lHeaderSize 멤버의 헤더 크기는 0으로 보고됩니다.
다중 페이지 TIFF 및 압축된 형식과 마찬가지로 데이터 취득 후까지 이미지의 실제 최종 크기를 알 수 없는 이미지 형식의 경우 MINIDRV_TRANSFER_CONTEXT 구조체의 lItemSize 멤버는 0으로 보고됩니다. lImageSize 멤버는 단일 페이지에서 압축되지 않은 이미지의 크기(바이트)로 보고됩니다.
lFlags 매개 변수에 WIAS_INIT_CONTEXT 지정하면 pmdtc 매개 변수가 가리키는 MINIDRV_TRANSFER_CONTEXT 구조체가 항목의 이미지 속성에서 파생된 정보로 채워집니다. 미니드라이버에서 새 컨텍스트를 할당한 경우 이 플래그를 사용해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamdef.h(Wiamdef.h 포함) |
| 라이브러리 | Wiaservc.lib |
| DLL | Wiaservc.dll |