ISensorDriver::OnGetProperties 메서드(sensorsclassextension.h)
ISensorDriver::OnGetProperties 메서드는 지정된 센서에서 지정된 속성의 값을 검색합니다.
구문
HRESULT OnGetProperties(
IWDFFile *pClientFile,
LPWSTR pwszSensorID,
IPortableDeviceKeyCollection *pProperties,
IPortableDeviceValues **ppPropertyValues
);
매개 변수
pClientFile
속성 값을 요청하는 애플리케이션의 파일 개체를 나타내는 IWDFFile 인터페이스에 대한 포인터입니다.
pwszSensorID
클라이언트 애플리케이션이 속성 값을 요청하는 센서의 ID를 포함하는 LPWSTR입니다.
pProperties
요청되는 속성을 나타내는 PROPERTYKEY 값 목록이 포함된 IPortableDeviceKeyCollection에 대한 포인터입니다.
ppPropertyValues
요청된 속성 값을 수신하는 IPortableDeviceValues 포인터의 주소입니다.
반환 값
작업이 성공하면 이 메서드는 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.
설명
속성은 센서 생성 데이터를 포함하는 데이터 필드와 달리 센서 디바이스를 설명합니다. 플랫폼 정의 속성은 sensors.h에 정의됩니다.
애플리케이션은 사용자가 센서에 대한 권한을 부여하기 전에 일부 센서 속성 정보에 액세스할 수 있습니다. 이러한 항목은 sensors.h에 정의된 다음 ID로 제한됩니다.
- "SENSOR_PROPERTY_"로 시작하는 모든 PROPERTYKEY 입니다.
- "SENSOR_CATEGORY_"로 시작하는 모든 범주 GUID 입니다.
센서 클래스 확장은 이 메서드에서 반환된 PROPVARIANT 구조를 해제합니다.
센서 속성에는 사용자를 식별하는 데 사용할 수 있는 정보가 포함되어서는 안 됩니다. 사용자 개인 정보에 대한 자세한 내용은 센서 및 위치 플랫폼의 개인 정보 및 보안을 참조하세요.
IPortableDeviceKeyCollection 및 IPortableDeviceValues 는 Windows 이식 가능한 디바이스에 설명되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | sensorsclassextension.h |
| 라이브러리 | SensorsClassExtension.lib |