Méthode ISensorClassExtension ::P ostStateChange (sensorsclassextension.h)

Article
03/01/2024

La méthode ISensorClassExtension ::P ostStateChange informe l’extension de classe de capteur d’une modification de l’état opérationnel du capteur.

Syntaxe

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

Paramètres

[in] pwszSensorID

LPWSTR qui contient l’ID du capteur pour lequel le pilote déclenche l’événement.

[in] state

Valeur SensorState qui indique le nouvel état.

Valeur retournée

Cette méthode retourne un HRESULT. Les valeurs possibles incluent, sans s’y limiter, l’une des valeurs suivantes.

Code de retour	Description
S_OK	S_OK
E_POINTER	Un argument de pointeur requis était NULL.
HRESULT_FROM_WIN32(ERROR_CAN_NOT_COMPLETE)	L’extension de classe n’est pas initialisée.

Remarques

Les informations sur l’état du capteur sont également disponibles via la clé de propriété SENSOR_PROPERTY_STATE .

Exemples

L’exemple de code suivant illustre une fonction qui publie un événement de modification d’état.

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;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, disponible dans Windows 7.
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	sensorsclassextension.h
Bibliothèque	SensorsClassExtension.lib

Partager via