Metodo ISensorDriver::OnGetSupportedEvents (sensorsclassextension.h)

Il metodo ISensorDriver::OnGetSupportedEvents recupera l'elenco di eventi che il sensore specificato può generare.

Sintassi

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

Parametri

pwszSensorID

LPWSTR che contiene l'ID del sensore da cui l'applicazione client richiede l'elenco di eventi.

ppSupportedEvents

Indirizzo di un puntatore GUID che riceve la matrice di ID evento supportati. Se il driver non supporta gli eventi, restituisce un buffer contenente un singolo GUID con il relativo valore impostato su GUID_NULL.

pulEventCount

Indirizzo di una ULONG che riceve il conteggio degli ID evento nel buffer restituito tramite ppSupportedEvents. Se il driver non supporta gli eventi, impostare questo valore su zero.

Valore restituito

Se l'operazione ha esito positivo, questo metodo restituisce S_OK. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Commenti

Gli ID evento sono rappresentati da GUID. Gli eventi definiti dalla piattaforma sono definiti in sensors.h.

È necessario usare CoTaskMemAlloc per creare il buffer dell'ID evento. L'estensione della classe del sensore libera questa memoria.

Requisiti

Vedi anche

ISensorDriver