Функция SensorsCxSensorCreate (sensorscx.h)

Эта функция создает экземпляр датчика в расширении класса.

Синтаксис

NTSTATUS SensorsCxSensorCreate(
  [in]  WDFDEVICE              FxDevice,
  [in]  PWDF_OBJECT_ATTRIBUTES pSensorAttributes,
  [out] PSENSOROBJECT          pSensor
);

Параметры

[in] FxDevice

Дескриптор WDFDEVICE для объекта устройства платформы, представляющего датчик.

[in] pSensorAttributes

Ссылка на WDF_OBJECT_ATTRIBUTES.

[out] pSensor

Ссылка на объект датчика, используемый в расширении класса.

Возвращаемое значение

Эта функция возвращает NTSTATUS с разными значениями. Некоторые значения, которые могут быть возвращены:

  • STATUS_SUCCESS возвращается после успешного завершения функции.
  • STATUS_INVALID_PARAMETER возвращается, если какой-либо из параметров _In_ имеет значение NULL.
  • STATUS_INSUFFICIENT_RESOURCES возвращается, если ресурсов недостаточно для выделения памяти для этой функции.

Комментарии

SensorsCxSensorCreate реализуется расширением класса и должен вызываться драйвером.

Примечание Если параметру pSensorAttributes->ParentObject не задано значение NULL или FxDevice, то SensorsCxSensorCreate завершится ошибкой. Если pSensorAttributes->ParentObject имеет значение NULL, расширение класса (CX) установит для него значение FxDevice.
 

Расширение класса датчиков записывает набор свойств для каждого датчика, когда SensorsCxSensorCreate. Дополнительные сведения об этих свойствах см. в разделе Свойства перечисления.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть sensorscx.h

См. также раздел

Свойства перечисления

WDF_OBJECT_ATTRIBUTES