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호출하여 문자열로 변환할 수 있습니다.
발언
WIA 서비스에서 IWiaMiniDrv::d rvDeviceCommand 메서드를 호출하여 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 포함) |