ISensorDriver::OnClientUnsubscribeFromEvents 메서드(sensorsclassextension.h)

ISensorDriver::OnClientUnsubscribeFromEvents 메서드는 클라이언트 애플리케이션이 더 이상 이벤트 알림을 요청하지 않는다는 것을 센서 드라이버에 알릴 수 있습니다.

구문

HRESULT OnClientUnsubscribeFromEvents(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

매개 변수

pClientFile

이벤트 알림 취소를 요청하는 애플리케이션의 파일 개체를 나타내는 IWDFFile 인터페이스에 대한 포인터입니다.

pwszSensorID

클라이언트 애플리케이션이 이벤트 알림 취소를 요청하는 센서의 ID를 포함하는 LPWSTR입니다.

반환 값

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

설명

센서 클래스 확장은 다음 인스턴스에서 이 메서드를 호출합니다.

• 애플리케이션은 이벤트에서 구독을 취소합니다.
• 애플리케이션이 정상적으로 닫힙니다.
• 사용자는 애플리케이션이 지정된 센서가 포함된 디바이스에 액세스할 수 있는 권한을 취소합니다.
• 센서 클래스 확장이 종료됩니다.
• ISensorClassExtension::CleanupFile 호출의 정리 작업이 완료되었습니다.

이 호출을 신호로 사용하여 지정된 센서에 대한 이벤트를 요청하는 애플리케이션의 참조 수를 업데이트할 수 있습니다.

이 메서드를 사용하는 방법에 대한 자세한 내용은 데이터 필터링을 참조하세요.

ClientData 구조체는 다음과 같이 정의됩니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	sensorsclassextension.h
라이브러리	SensorsClassExtension.lib

추가 정보

ISensorDriver