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 d’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ée par le biais de ppSupportedEvents. Si le pilote ne prend pas en charge les événements, définissez cette valeur sur zéro.
Valeur de retour
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 GUIDs. 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | sensorsclassextension.h |
| bibliothèque | SensorsClassExtension.lib |