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

아티클
02/07/2025

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 연산자가 결합한 플래그 중 하나일 수 있습니다.

기	묘사
WIA_DEVICE_COMMANDS	배열은 디바이스 명령으로 구성됩니다.
WIA_DEVICE_EVENTS	배열은 디바이스 이벤트로 구성됩니다.

__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 서비스는 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 헤더에는 미리 정의된 여러 명령과 이벤트가 나열됩니다.