Compartilhar via


Função SensorsCxSensorCreate (sensorscx.h)

Essa função cria uma instância de um sensor na extensão de classe.

Sintaxe

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

Parâmetros

[in] FxDevice

Um identificador WDFDEVICE para o objeto de dispositivo de estrutura que representa o sensor.

[in] pSensorAttributes

Uma referência a WDF_OBJECT_ATTRIBUTES.

[out] pSensor

Uma referência a um objeto de sensor que é usado dentro da extensão de classe.

Retornar valor

Essa função retorna NTSTATUS com valores diferentes. Alguns valores que podem ser retornados são os seguintes:

  • STATUS_SUCCESS é retornado quando a função é concluída com êxito.
  • STATUS_INVALID_PARAMETER será retornado se qualquer um dos parâmetros _In_ for NULL.
  • STATUS_INSUFFICIENT_RESOURCES será retornado se não houver recursos suficientes para alocar memória para essa função.

Comentários

SensorsCxSensorCreate é implementado pela extensão de classe e deve ser chamado pelo driver.

Nota Se pSensorAttributes->ParentObject não estiver definido como NULL ou FxDevice, sensorsCxSensorCreate falhará. Se pSensorAttributes->ParentObject for NULL, a extensão de classe (CX) a definirá como FxDevice.
 

A extensão de classe de sensores grava um conjunto de propriedades para cada sensor quando SensorsCxSensorCreate. Para obter informações sobre essas propriedades, consulte Propriedades de enumeração.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho sensorscx.h

Confira também

Propriedades de enumeração

WDF_OBJECT_ATTRIBUTES