Méthode ISensorDriver ::OnGetSupportedEvents (sensorsclassextension.h)

La méthode ISensorDriver ::OnGetSupportedEvents récupère la liste des événements que le capteur spécifié peut déclencher.

Syntaxe

HRESULT OnGetSupportedEvents(
  LPWSTR pwszSensorID,
  GUID   **ppSupportedEvents,
  ULONG  *pulEventCount
);

Paramètres

pwszSensorID

LPWSTR qui contient l’ID du capteur à partir duquel l’application cliente demande la liste des événements.

ppSupportedEvents

Adresse d’un pointeur GUID qui reçoit le tableau des ID d’événement pris en charge. Si le pilote ne prend pas en charge les événements, retournez une mémoire tampon contenant un GUID unique dont la valeur est définie sur GUID_NULL.

pulEventCount

Adresse d’un ULONG qui reçoit le nombre d’ID d’événement dans la mémoire tampon retournés par le biais de ppSupportedEvents. Si le pilote ne prend pas en charge les événements, définissez cette valeur sur zéro.

Valeur retournée

Si l’opération réussit, cette méthode retourne S_OK. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Remarques

Les ID d’événement sont représentés par des GUID. Les événements définis par la plateforme sont définis dans sensors.h.

Vous devez utiliser CoTaskMemAlloc pour créer la mémoire tampon d’ID d’événement. L’extension de classe de capteur libère cette mémoire.

Configuration requise

Voir aussi

ISensorDriver