wiasGetImageInformation 함수(wiamdef.h)

wiasGetImageInformation 함수는 항목에서 전송 컨텍스트 정보를 검색합니다.

구문

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

매개 변수

[in] pWiasContext

WIA 항목 컨텍스트에 대한 포인터입니다.

lFlags

작업 플래그를 지정합니다. 현재 다음 플래그만 정의됩니다.

[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 구조체가 항목의 이미지 속성에서 파생된 정보로 채워집니다. 미니드라이버에서 새 컨텍스트를 할당한 경우 이 플래그를 사용해야 합니다.

요구 사항

추가 정보

MINIDRV_TRANSFER_CONTEXT