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

ISensorDriver::OnGetDataFields 메서드는 현재 센서 데이터를 검색합니다.

구문

HRESULT OnGetDataFields(
  IWDFFile                     *pClientFile,
  LPWSTR                       pwszSensorID,
  IPortableDeviceKeyCollection *pDataFields,
  IPortableDeviceValues        **ppDataValues
);

매개 변수

pClientFile

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

pwszSensorID

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

pDataFields

요청되는 데이터 필드를 나타내는 PROPERTYKEY 값 목록이 포함된 IPortableDeviceKeyCollection에 대한 포인터입니다.

ppDataValues

요청된 데이터를 수신하는 IPortableDeviceValues 포인터의 주소입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 값 중 하나를 포함하지만 이에 국한되지 않습니다.

반환 코드	설명
S_OK	메서드가 성공했습니다.
HRESULT_FROM_WIN32(ERROR_NO_DATA)	센서에 보고할 데이터가 없습니다. ppDataValues 매개 변수에 반환된 각 데이터 필드는 VT_EMPTY.

설명

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

이 메서드에서 반환된 각 IPortableDeviceValues 개체에는 SENSOR_CATEGORY_ALL 설명된 대로 타임스탬프를 포함해야 합니다.

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

센서 클래스 확장은 사용자가 제어판 통해 권한을 부여한 센서에 대해서만 이 메서드를 호출합니다.

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

요구 사항

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

추가 정보

ISensorDriver