WIA_DEV_CAP_DRV 구조체(wiamindr_lh.h)

WIA_DEV_CAP_DRV 구조는 디바이스 기능을 열거하는 데 사용됩니다. 디바이스 기능은 디바이스가 지원하는 이벤트 또는 명령에 의해 정의됩니다.

구문

typedef struct _WIA_DEV_CAP_DRV {
  GUID     *guid;
  ULONG    ulFlags;
  LPOLESTR wszName;
  LPOLESTR wszDescription;
  LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;

멤버

guid

디바이스 기능을 식별하는 GUID를 가리킵니다. 이 멤버는 WIA 디바이스 명령(WIA_CMD_XXX 명령) 또는 WIA 이벤트 식별자(WIA_EVENT_XXX 이벤트 식별자)에 대해 지정된 값으로 설정할 수 있습니다. 자세한 내용은 WIA 디바이스 명령을 참조하세요.

드라이버는 디바이스로 보낼 수 있는 고유한 기능 GUID를 정의할 수 있습니다. 그러나 애플리케이션이 새 기능에 응답하려면 해당 기능에 대한 특정 지식이 있어야 합니다. 애플리케이션은 일반적으로 표준 WIA 명령 및 이벤트 GUID(WIA_CMD_XXX 및 WIA_EVENT_XXX)만 인식합니다.

ulFlags

이벤트의 유형을 지정합니다. 이 멤버는 다음 중 하나 또는 둘 다로 설정할 수 있습니다.

플래그 의미
WIA_ACTION_EVENT 애플리케이션은 IWiaDevMgr::RegisterEventCallbackProgramIwiaDevMgr::RegisterEventCallbackCLSID 메서드를 사용하여 지정된 이벤트에 대한 작업을 등록할 수 있습니다. 작업 이벤트는 이러한 이벤트를 처리하기 위해 등록된 애플리케이션을 시작합니다.
WIA_NOTIFICATION_EVENT 애플리케이션은 IwiaDevMgr::RegisterEventCallbackInterface 메서드를 사용하여 지정된 이벤트에 대한 알림을 등록할 수 있습니다. 알림 이벤트는 이미 실행 중인 애플리케이션에만 전송됩니다.

wszName

기능 이름의 짧은 버전을 포함하는 문자열을 지정합니다.

wszDescription

사용자에게 표시할 수 있는 기능 이름의 버전을 포함하는 문자열을 지정합니다.

wszIcon

이 기능에 대한 아이콘의 이름을 포함하는 문자열을 지정합니다. 아이콘을 사용자에게 표시할 수 있습니다.

설명

WIA 서비스는 미니드라이버의 IWiaMiniDrv::d rvGetCapabilities 함수를 호출하여 WIA_DEV_CAP_DRV 구조체의 멤버를 채웁니다.

드라이버가 이벤트 처리기를 열거하는 경우 유일한 유효한 값은 WIA_IS_DEFAULT_HANDLER. 현재 등록된 처리기를 사용해야 했음을 나타냅니다.

요구 사항

요구 사항
헤더 wiamindr_lh.h(Wiamindr.h 포함)

추가 정보

드라이버 기능

IWiaMiniDrv::d rvGetCapabilities