SensorsCxSensorCreate 函式 (sensorscx.h)
此函式會在類別延伸模組中建立感測器的實例。
語法
NTSTATUS SensorsCxSensorCreate(
[in] WDFDEVICE FxDevice,
[in] PWDF_OBJECT_ATTRIBUTES pSensorAttributes,
[out] PSENSOROBJECT pSensor
);
參數
[in] FxDevice
代表感測器之架構裝置物件的 WDFDEVICE 句柄。
[in] pSensorAttributes
[out] pSensor
類別延伸模組內所使用之感測器對象的參考。
傳回值
此函式會傳回具有不同值的NTSTATUS。 可能會傳回的一些值如下:
- 函式成功完成時會傳回STATUS_SUCCESS。
- 如果任何 _In_ 參數為 NULL,則會傳回STATUS_INVALID_PARAMETER。
- 如果資源不足,無法配置此函式的記憶體,則會傳回STATUS_INSUFFICIENT_RESOURCES。
備註
SensorsCxSensorCreate 是由類別延伸模組所實作,而且必須由驅動程式呼叫。
注意 如果 pSensorAttributes->ParentObject 未設定為 NULL 或 FxDevice,SensorsCxSensorCreate 將會失敗。 如果 pSensorAttributes->ParentObject 為 NULL,則 CX () 的類別延伸模組會將它設定為 FxDevice。
當 SensorsCxSensorCreate 時,感測器類別延伸模組會為每個感測器寫入一組屬性。 如需這些屬性的相關信息,請參閱列舉屬性。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | sensorscx.h |