SensorsCxSensorCreate, fonction (sensorscx.h)
Cette fonction crée une instance d’un capteur dans l’extension de classe.
Syntaxe
NTSTATUS SensorsCxSensorCreate(
[in] WDFDEVICE FxDevice,
[in] PWDF_OBJECT_ATTRIBUTES pSensorAttributes,
[out] PSENSOROBJECT pSensor
);
Paramètres
[in] FxDevice
Handle WDFDEVICE pour l’objet d’appareil framework qui représente le capteur.
[in] pSensorAttributes
Référence à WDF_OBJECT_ATTRIBUTES.
[out] pSensor
Référence à un objet capteur utilisé dans l’extension de classe.
Valeur de retour
Cette fonction retourne NTSTATUS avec différentes valeurs. Certaines valeurs qui peuvent être retournées sont les suivantes :
- STATUS_SUCCESS est retourné lorsque la fonction se termine correctement.
- STATUS_INVALID_PARAMETER est retourné si l’un des paramètres _In_ a la valeur NULL.
- STATUS_INSUFFICIENT_RESOURCES est retourné s’il y avait des ressources insuffisantes pour allouer de la mémoire pour cette fonction.
Remarques
SensorsCxSensorCreate est implémenté par l’extension de classe et doit être appelé par le pilote.
Remarque Si pSensorAttributes->ParentObject n’est pas défini sur NULL ou FxDevice, SensorsCxSensorCreate échoue. Si pSensorAttributes->ParentObject a la valeur NULL, l’extension de classe (CX) la définit sur FxDevice.
L’extension de classe de capteurs écrit un ensemble de propriétés pour chaque capteur lorsque SensorsCxSensorCreate. Pour plus d’informations sur ces propriétés, consultez Propriétés d’énumération.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | sensorscx.h |