IStiUSD::SetNotificationHandle 메서드(stiusd.h)

  • 아티클

스틸 이미지 미니드라이버의 IStiUSD::SetNotificationHandle 메서드는 미니드라이버가 호출자에게 디바이스 이벤트를 알리는 데 사용해야 하는 이벤트 핸들을 지정합니다.

구문

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

매개 변수

hEvent

CreateEvent를 호출하여 만든 Win32 이벤트에 대한 호출자 제공 핸들입니다.

반환 값

작업이 성공하면 메서드는 S_OK 반환해야 합니다. 그렇지 않으면 stierr.h에 정의된 STIERR 접두사 오류 코드 중 하나를 반환해야 합니다.

설명

드라이버(및 디바이스)가 스틸 이미지 디바이스 이벤트의 비동기 알림을 지원하는 경우 미니드라이버의 IStiUSD::SetNotificationHandle 메서드는 이벤트 모니터가 이벤트가 발생할 때 드라이버에 알리도록 요청하는 수단입니다.

hEvent가 이벤트 핸들인 경우 IStiUSD::SetNotificationHandle 메서드는 핸들을 저장하고 SetEvent에 대한 입력 인수로 사용해야 합니다(Microsoft Windows SDK 설명서에 설명됨). 드라이버는 디바이스 이벤트가 감지될 때마다 SetEvent 를 호출하여 이벤트 모니터에 이벤트가 발생했음을 알려야 합니다.

hEvent가 NULL인 경우 메서드는 디바이스 이벤트에 대한 알림을 사용하지 않도록 설정해야 합니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 stiusd.h(Stiusd.h 포함)