IWiaMiniDrv::d rvGetCapabilities 메서드(wiamindr_lh.h)

IWiaMiniDrv::d rvGetCapabilities 메서드는 디바이스에서 지원하는 이벤트 및 명령 배열을 반환합니다.

구문

HRESULT drvGetCapabilities(
  BYTE            *__MIDL__IWiaMiniDrv0048,
  LONG            __MIDL__IWiaMiniDrv0049,
  LONG            *__MIDL__IWiaMiniDrv0050,
  WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
  LONG            *__MIDL__IWiaMiniDrv0052
);

매개 변수

__MIDL__IWiaMiniDrv0048

lFlags [in]

ppCapabilites가 가리키는 배열이 명령, 이벤트 또는 둘 다로 구성되는지 여부를 지정합니다. 이 매개 변수는 다음 플래그 중 하나이거나 OR 연산자가 결합한 플래그 중 하나일 수 있습니다.

__MIDL__IWiaMiniDrv0049

pWiasContext [in]

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

__MIDL__IWiaMiniDrv0050

pcelt [out]

ppCapabilities 매개 변수가 가리키는 배열의 요소 수를 받을 메모리 위치를 가리킵니다.

__MIDL__IWiaMiniDrv0051

plDevErrVal [out]

이 메서드에 대한 상태 코드를 받을 메모리 위치를 가리킵니다. 이 메서드가 S_OK 반환하면 저장된 값은 0이 됩니다. 그렇지 않으면 미니 드라이버 관련 오류 코드가 이 매개 변수가 가리키는 위치에 저장됩니다.

__MIDL__IWiaMiniDrv0052

ppCapabilities [out, optional]

디바이스에서 지원하는 이벤트 및 명령의 GUID를 포함하는 WIA_DEV_CAP_DRV 구조 배열의 첫 번째 요소 주소를 수신하는 메모리 위치를 가리킵니다.

반환 값

성공하면 메서드는 S_OK 반환하고 plDevErrVal이 가리키는 디바이스 오류 값을 지워야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErrVal이 가리키는 메모리에 미니 드라이버 관련 오류 코드 값을 배치해야 합니다.

plDevErrVal이 가리키는 값은 IWiaMiniDrv::d rvGetDeviceErrorStr를 호출하여 문자열로 변환할 수 있습니다.

설명

WIA 서비스는 minidriver 메서드 IWiaMiniDrv::d rvGetCapabilities 를 호출하여 하드웨어 명령 기능 및/또는 디바이스 이벤트 목록을 가져옵니다. 이 호출에 대한 응답으로 미니 드라이버는 GUID 데이터에 대한 포인터 배열의 주소로 ppCapabilities 를 설정합니다. 각 GUID는 이미징 디바이스에서 지원하는 이벤트 알림 또는 디바이스 명령에 해당합니다. lFlags 매개 변수가 WIA_DEVICE_COMMANDS 설정되면 GUID 배열에 디바이스 명령이 포함됩니다. lFlags가 WIA_DEVICE_EVENTS 설정되면 GUID 배열에 이벤트가 포함됩니다. lFlags가 WIA_DEVICE_COMMANDS | 로 설정된 경우 WIA_DEVICE_EVENTS GUID 배열에는 해당 순서로 나열된 이벤트와 명령이 모두 포함됩니다.

Wiadef.h 헤더에는 미리 정의된 여러 명령 및 이벤트가 나열됩니다.

요구 사항

추가 정보

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr

WIA_DEV_CAP_DRV