ISensor::GetProperties 메서드(sensorsapi.h)

중요합니다

대신 UWP 센서 API 를 사용합니다.

COM 기반 센서 API는 더 이상 사용되지 않으며 새 애플리케이션에서 사용해서는 안 됩니다. 추가 기능 또는 향상된 기능은 계획되지 않으며 지원이 제한됩니다.

여러 센서 속성을 검색합니다.

Syntax

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

[in] pKeys

요청되는 속성 값에 대한 PROPERTYKEY 컬렉션을 포함하는 IPortableDeviceKeyCollection 인터페이스에 대한 포인터입니다. 지원되는 모든 속성을 검색하려면 NULL 로 설정합니다.

[out] ppProperties

요청된 속성 값에 대한 포인터를 받는 IPortableDeviceValues 포인터의 주소입니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
S_FALSE	센서 드라이버는 지정된 속성 중 하나 이상을 지원하지 않습니다. IPortableDeviceValues 인터페이스를 통해 반환된 지원되지 않는 각 속성 PROPVARIANT에는 오류 값이 HRESULT_FROM_WIN32(ERROR_NOT_FOUND)로 설정됩니다.
E_POINTER	NULL은 ppProperties에 대해 전달되었습니다.

이 메서드를 사용하면 단일 호출을 수행하여 센서 메이크, 모델 및 일련 번호와 같은 여러 속성의 값을 검색할 수 있습니다. 단일 속성을 검색하려면 ISensor::GetProperty를 호출합니다.

IPortableDeviceKeyCollection 및 IPortableDeviceValues 인터페이스는 Windows 이식 가능한 디바이스 API에 의해 정의됩니다.

센서에서 속성을 검색하는 방법의 예는 센서 속성 설정 및 검색을 참조하세요.

이 페이지가 도움이 되었나요?