Condividi tramite


Metodo ISensor::GetData (sensorsapi.h)

Recupera il report dei dati del sensore più recente.

Sintassi

HRESULT GetData(
  [out] ISensorDataReport **ppDataReport
);

Parametri

[out] ppDataReport

Indirizzo di un puntatore ISensorDataReport che riceve il puntatore al report dati del sensore più recente.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_INVALIDARG
Il driver del sensore ha fornito dati in formato non corretto. Ad esempio, i dati erano di un tipo non supportato. Per informazioni sui tipi di dati dei campi dati definiti dalla piattaforma, vedere Categorie, tipi e campi dati dei sensori.
HRESULT_FROM_WIN32(ERROR_NO_DATA)
Il sensore non contiene dati da segnalare. Ad esempio, un sensore GPS potrebbe essere in fase di acquisizione di una correzione satellitare.
E_POINTER
NULL è stato passato per ppDataReport.

Commenti

Per i sensori di posizione, è possibile recuperare i dati solo dai sensori per i quali l'utente ha concesso l'autorizzazione.

Questo metodo può restituire dati prima che il driver abbia impostato lo stato su SENSOR_STATE_READY.

Esempio

Per un esempio di come recuperare i dati del sensore, vedere Recupero dei valori dei dati dei sensori.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione sensorsapi.h
Libreria Sensorsapi.lib
DLL Sensorsapi.dll

Vedi anche

ISensor

Gestione delle autorizzazioni utente

RequestPermissions

Categorie, tipi e campi dati dei sensori