IWiaMiniDrv::d rvGetWiaFormatInfo 메서드(wiamindr_lh.h)
IWiaMiniDrv::d rvGetWiaFormatInfo 메서드는 WIA 하드웨어 디바이스에서 지원하는 이미지 형식 및 미디어 유형을 찾습니다.
구문
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
매개 변수
__MIDL__IWiaMiniDrv0059
lFlags [in]
예약되어 있습니다.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
WIA 항목 컨텍스트에 대한 포인터입니다.
__MIDL__IWiaMiniDrv0061
pcelt [out]
ppwfi가 가리키는 배열의 항목 수를 받을 메모리 위치를 가리킵니다.
__MIDL__IWiaMiniDrv0062
plDevErrVal [out]
이 메서드에 대한 상태 코드를 받을 메모리 위치를 가리킵니다. 이 메서드가 S_OK 반환하는 경우 저장된 값은 0이 됩니다. 그렇지 않으면 미니 드라이버 관련 오류 코드가 이 매개 변수가 가리키는 위치에 저장됩니다.
__MIDL__IWiaMiniDrv0063
ppwfi [out, optional]
WIA_FORMAT_INFO 구조체 배열의 첫 번째 요소 주소를 받을 메모리 위치를 가리킵니다.
반환 값
성공하면 메서드는 S_OK 반환하고 plDevErrVal이 가리키는 디바이스 오류 값을 지워야 합니다. 데이터를 포함하지 않는 항목에 대해 이 메서드가 호출되면 E_INVALIDARG 반환해야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErrVal이 가리키는 메모리에 미니드라이버 관련 오류 코드 값을 배치해야 합니다.
plDevErrVal이 가리키는 값은 IWiaMiniDrv::d rvGetDeviceErrorStr를 호출하여 문자열로 변환할 수 있습니다.
설명
이 메서드는 WIA 하드웨어 디바이스에서 지원하는 미디어 유형 및 이미지 형식을 설명하는 WIA_FORMAT_INFO 구조의 배열을 만듭니다. 배열의 각 요소에 대해 미디어 형식은 TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILE 또는 TYMED_MULTIPAGE_FILE 중 하나일 수 있습니다. 이미지 형식의 일반적인 값에는 WiaImgFmt_JPEG 및 WiaImgFmt_BMP 등이 있습니다. 자세한 내용은 TYMED 및 WIA_IPA_FILENAME_EXTENSION 이해를 참조 하세요.
미니 드라이버는 WIA_FORMAT_INFO 구조를 보유할 전역 배열을 정의하거나 배열에 대한 메모리를 할당할 수 있습니다. WIA 서비스는 할당된 메모리를 해제하지 않으므로 미니드라이버가 해당 메모리에 대한 포인터를 드라이버 항목 컨텍스트에 저장해야 합니다. 그런 다음 미니 드라이버는 IWiaMiniDrv::d rvFreeDrvItemContext 호출에서 이 메모리를 해제할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamindr_lh.h(Wiamindr.h 포함) |