다음을 통해 공유

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

  • 아티클

ISensorDriver::OnClientConnect 메서드는 클라이언트 애플리케이션이 연결되었음을 센서 드라이버에 알릴 수 있습니다.

구문

HRESULT OnClientConnect(
  IWDFFile *pClientFile,
  LPWSTR   pwszSensorID
);

매개 변수

pClientFile

연결을 요청하는 애플리케이션의 파일 개체를 나타내는 IWDFFile 인터페이스에 대한 포인터입니다.

pwszSensorID

클라이언트 애플리케이션이 연결하는 센서의 ID를 포함하는 LPWSTR입니다.

반환 값

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

설명

센서 클래스 확장은 사용자가 드라이버에 액세스할 수 있는 권한을 지정된 클라이언트 애플리케이션에 부여한 경우에만 이 메서드를 호출합니다. 사용자가 이 권한을 취소하면 클래스 확장은 동일한 애플리케이션/센서 쌍 에 대해 ISensorDriver::OnClientDisconnect 를 즉시 호출합니다.

클래스 확장은 특정 센서에 대해 ISensorDriver::OnSetProperties 또는 ISensorDriver::OnGetDataFields 를 호출하기 전에 항상 이 메서드를 호출합니다. 이러한 세 가지 메서드에 대한 호출이 가능한 시기를 예측하는 데 도움이 되도록 연결된 애플리케이션의 참조 수를 유지하는 것이 좋습니다. 클라이언트 애플리케이션이 연결되지 않은 경우 예를 들어 전력 소비를 줄이기 위한 단계를 수행하여 드라이버의 동작을 변경할 수 있습니다.

pClientFile에서 제공하는 포인터 값(가리키는 주소)을 일종의 ID로 사용하여 연결된 애플리케이션을 추적할 수 있습니다. 그러나 클래스 확장이 동일한 디바이스의 여러 센서에 동일한 포인터 값을 제공할 수 있으므로 각 디바이스가 아닌 각 센서에 대해 이러한 ID를 개별적으로 추적해야 합니다.

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

요구 사항

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

추가 정보

ISensorDriver