IWiaMiniDrv::d rvDeviceCommand 메서드(wiamindr_lh.h)
IWiaMiniDrv::d rvDeviceCommand 메서드는 WIA 디바이스에 명령을 실행합니다.
구문
HRESULT drvDeviceCommand(
BYTE *__MIDL__IWiaMiniDrv0043,
LONG __MIDL__IWiaMiniDrv0044,
const GUID *__MIDL__IWiaMiniDrv0045,
IWiaDrvItem **__MIDL__IWiaMiniDrv0046,
LONG *__MIDL__IWiaMiniDrv0047
);
매개 변수
__MIDL__IWiaMiniDrv0043
lFlags [in]
예약되어 있습니다.
__MIDL__IWiaMiniDrv0044
pWiasContext [in]
WIA 항목 컨텍스트에 대한 포인터입니다.
__MIDL__IWiaMiniDrv0045
plCommand [in]
WIA 명령 GUID를 가리킵니다.
__MIDL__IWiaMiniDrv0046
plDevErrVal [out]
이 메서드에 대한 상태 코드를 받을 메모리 위치를 가리킵니다. 이 메서드가 S_OK 반환하면 저장된 값은 0이 됩니다. 그렇지 않으면 미니 드라이버 관련 오류 코드가 이 매개 변수가 가리키는 위치에 저장됩니다.
__MIDL__IWiaMiniDrv0047
ppWiaDrvItem [out, optional]
IWiaDrvItem 인터페이스에 대한 포인터를 받을 수 있는 메모리 위치를 가리킵니다. 아래 설명 부분을 참조하세요.
반환 값
성공하면 메서드는 S_OK 반환하고 plDevErrVal이 가리키는 디바이스 오류 값을 지워야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErrVal이 가리키는 메모리에 미니 드라이버 관련 오류 코드 값을 배치해야 합니다.
plDevErrVal이 가리키는 값은 IWiaMiniDrv::d rvGetDeviceErrorStr를 호출하여 문자열로 변환할 수 있습니다.
설명
IWiaMiniDrv::d rvDeviceCommand 메서드는 WIA 서비스에서 호출되어 WIA 서비스 또는 애플리케이션에서 생성된 명령을 디바이스에 발급합니다. WIA 서비스는 IWiaMiniDrv::d rvGetCapabilities 메서드에서 디바이스가 지원할 수 있는 명령에 대해 IWiaMiniDrv::d rvDeviceCommand 메서드만 호출합니다.
미니드라이버가 일반적으로 가리키는 메모리 위치를 설정하지 않으므로 ppWiaDrvItem 매개 변수는 선택 사항으로 간주되어야 합니다. 그러나 특정 명령의 경우 미니 드라이버는 이 매개 변수가 가리키는 위치에 새로 만든 항목의 주소를 배치합니다. 예를 들어 사진을 찍는 명령이 실행되면(plCommand 가 WIA_CMD_TAKE_PICTURE 설정됨) 디바이스는 새 이미지를 생성하여 미니드라이버가 드라이버 항목 트리에 새 항목을 만들고 *ppWiaDrvItem 을 새 항목의 주소로 설정합니다. 그러면 WIA 서비스에 새 항목이 생성되었음을 알립니다.
미니드라이버에는 디바이스가 IWiaMiniDrv::d rvGetCapabilities 메서드에서 지원할 수 있는 사용자 지정 명령 목록이 포함될 수 있습니다.
WIA 서비스는 이 메서드를 호출하기 전에 속성을 작성하지 않습니다. 명령이 속성 설정을 사용하는 경우 미니 드라이버는 명령을 실행하기 전에 IWiaMiniDrv::d rvWriteItemProperties 를 호출해야 합니다. 예를 들어 WIA_CMD_TAKE_PICTURE 사진을 찍는 명령은 명령을 실행하기 전에 디바이스에 기록해야 하는 셔터 속도 및 조리개 설정에 의존할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | wiamindr_lh.h(Wiamindr.h 포함) |