ISensorClassExtension::P ostStateChange-Methode (sensorsclassextension.h)

Artikel
02/26/2024

Die ISensorClassExtension::P ostStateChange-Methode benachrichtigt die Sensorklassenerweiterung über eine Änderung des Betriebszustands des Sensors.

Syntax

HRESULT PostStateChange(
  [in] LPWSTR      pwszSensorID,
  [in] SensorState state
);

Parameter

[in] pwszSensorID

LPWSTR , das die ID für den Sensor enthält, für den der Treiber das Ereignis auslöst.

[in] state

SensorState-Wert , der den neuen Zustand angibt.

Rückgabewert

Diese Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem einer der folgenden Werte.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Ein erforderliches Zeigerargument war NULL.
HRESULT_FROM_WIN32(ERROR_CAN_NOT_COMPLETE)	Die Klassenerweiterung wird nicht initialisiert.

Hinweise

Sensorstatusinformationen sind auch über den SENSOR_PROPERTY_STATE-Eigenschaftsschlüssel verfügbar.

Beispiele

Der folgende Beispielcode veranschaulicht eine Funktion, die ein Zustandsänderungsereignis sendet.

HRESULT PostStateEvent()
{
    // Validate that we have a pointer to the class extension.
    HRESULT hr = (NULL == m_spSensorCXT) ? E_UNEXPECTED : S_OK ;

    if (SUCCEEDED(hr))
    {
        SensorState st;

        // Retrieve the sensor state
        hr = m_pDdi->GetSensorState(&st);

        if (SUCCEEDED(hr))
        {
            // Post the state change event.
            hr = m_spSensorCXT->PostStateChange(g_wszSensorID, st);
        }
    }

    return hr;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, verfügbar in Windows 7.
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Desktop
Kopfzeile	sensorsclassextension.h
Bibliothek	SensorsClassExtension.lib

Freigeben über