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 da 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.
Valor de retorno
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.
Observações
SensorsCxSensorCreate é implementado pela extensão de classe e deve ser chamado pelo driver.
Observação Se pSensorAttributes->ParentObject não estiver definido como NULL ou FxDevice, o 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 as propriedades de Enumeração.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | sensorscx.h |