ISensorManager::GetSensorsByCategory method (sensorsapi.h)

Retrieves a collection containing all sensors associated with the specified category.

Syntax

HRESULT GetSensorsByCategory(
  [in]  REFSENSOR_CATEGORY_ID sensorCategory,
  [out] ISensorCollection     **ppSensorsFound
);

[in] sensorCategory

ID of the sensor category to retrieve.

[out] ppSensorsFound

Address of an ISensorCollection interface pointer that receives a pointer to the sensor collection requested.

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	No sensors are available for the specified category.
S_OK	The method succeeded.
E_POINTER	NULL was passed in for ppSensorsFound.