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

ISensorDriver::OnSetProperties 메서드는 지정된 속성 목록의 값을 지정합니다.

구문

HRESULT OnSetProperties(
  [in]  IWDFFile              *pClientFile,
  [in]  LPWSTR                pwszSensorID,
  [in]  IPortableDeviceValues *pPropertiesToSet,
  [out] IPortableDeviceValues **ppResults
);

매개 변수

[in] pClientFile

속성 값을 지정하는 애플리케이션의 파일 개체를 나타내는 IWDFFile 인터페이스에 대한 포인터입니다.

[in] pwszSensorID

클라이언트 애플리케이션이 속성 값을 지정하는 센서의 ID를 포함하는 LPWSTR입니다.

[in] pPropertiesToSet

설정할 속성 목록과 해당 값을 포함하는 IPortableDeviceValues 인터페이스에 대한 포인터입니다.

[out] ppResults

성공적으로 설정된 속성 목록과 새 값을 수신하는 IPortableDeviceValues 포인터의 주소입니다. 속성이 설정되지 않은 경우 새 값에 HRESULT 오류 코드가 포함됩니다.

반환 값

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

설명

속성은 센서 생성 데이터를 포함하는 데이터 필드와 달리 센서 디바이스를 설명합니다. 플랫폼 정의 속성은 sensors.h에 정의됩니다.

pPropertiesToSet을 통해 제공되는 속성 목록은 일반적으로 ISensorDriver::OnGetSupportedProperties를 통해 반환한 목록의 하위 집합입니다. 그러나 센서 클래스 확장은 클라이언트 애플리케이션에서 이 조건을 적용하지 않습니다.

센서 클래스 확장은 이 메서드에서 반환된 PROPVARIANT 구조를 해제합니다.

IPortableDeviceValues는 Windows 이식 가능한 디바이스에 설명되어 있습니다.

참고 이 메서드는 사용자가 위치 및 기타 센서 제어판에서 센서를 사용하도록 설정한 경우에만 호출됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 7,Windows 7에서 사용할 수 있습니다.
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	데스크톱
헤더	sensorsclassextension.h
라이브러리	SensorsClassExtension.lib

참고 항목

ISensorDriver

ISensorDriver::OnGetProperties