SensorsCxSensorCreate-Funktion (sensorscx.h)

Artikel
02/26/2024

Diese Funktion erstellt eine instance eines Sensors in der Klassenerweiterung.

Syntax

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

Parameter

[in] FxDevice

Ein WDFDEVICE-Handle für das Frameworkgerätobjekt, das den Sensor darstellt.

[in] pSensorAttributes

Ein Verweis auf WDF_OBJECT_ATTRIBUTES.

[out] pSensor

Ein Verweis auf ein Sensorobjekt, das innerhalb der Klassenerweiterung verwendet wird.

Rückgabewert

Diese Funktion gibt NTSTATUS mit unterschiedlichen Werten zurück. Einige Werte, die möglicherweise zurückgegeben werden, sind die folgenden:

STATUS_SUCCESS wird zurückgegeben, wenn die Funktion erfolgreich abgeschlossen wurde.
STATUS_INVALID_PARAMETER wird zurückgegeben, wenn einer der _In_-Parameter NULL ist.
STATUS_INSUFFICIENT_RESOURCES wird zurückgegeben, wenn nicht genügend Ressourcen vorhanden sind, um Arbeitsspeicher für diese Funktion zuzuweisen.

Hinweise

SensorsCxSensorCreate wird von der Klassenerweiterung implementiert und muss vom Treiber aufgerufen werden.

Hinweis Wenn pSensorAttributes->ParentObject nicht auf NULL oder FxDevice festgelegt ist, schlägt SensorsCxSensorCreate fehl. Wenn pSensorAttributes->ParentObject NULL ist, wird es von der Klassenerweiterung (CX) auf FxDevice festgelegt.

Die Sensorklassenerweiterung schreibt einen Satz von Eigenschaften für jeden Sensor, wenn SensorsCxSensorCreate. Informationen zu diesen Eigenschaften finden Sie unter Enumerationseigenschaften.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	sensorscx.h

Weitere Informationen

Enumerationseigenschaften

WDF_OBJECT_ATTRIBUTES

Freigeben über