wiasQueueEvent 함수(wiamdef.h)

wiasQueueEvent 함수는 디바이스가 이벤트를 생성했음을 서비스에 알릴 수 있습니다.

구문

HRESULT wiasQueueEvent(
  [in]           BSTR       bstrDeviceId,
  [in]           const GUID *pEventGUID,
  [in, optional] BSTR       bstrFullItemName
);

매개 변수

[in] bstrDeviceId

디바이스 ID를 지정합니다. IWiaMiniDrv::d rvInitializeWia 메서드 호출에서 미니 드라이버에 전달되는 값입니다.

[in] pEventGUID

이벤트에 대한 GUID를 포함하는 버퍼에 대한 포인터입니다.

[in, optional] bstrFullItemName

경로 정보를 포함하여 전체 항목 이름을 지정합니다.

반환 값

성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나가 반환됩니다.

설명

이 메서드는 디바이스에서 일부 유형의 이벤트가 발생했음을 신호해야 할 때마다 사용해야 합니다. 디바이스는 이벤트 큐에 이벤트를 배치하여 이 작업을 수행합니다. 예를 들어 카메라가 새 사진을 찍을 때 새 드라이버 항목을 트리에 추가한 후 WIA_EVENT_ITEM_CREATED 이벤트를 생성해야 합니다. 카메라는 다음과 같은 방식으로 이벤트 큐에 이 이벤트를 배치할 수 있습니다.

hr = wiasQueueEvent(bstrMyDeviceId,
                    &WIA_EVENT_ITEM_CREATED,
                    bstrDescriptionString);

WIA 이벤트 식별자의 전체 목록은 Windows SDK 설명서를 참조하세요.

요구 사항

추가 정보

IWiaMiniDrv::d rvInitializeWia