Metodo ISensorDriver::OnClientConnect (sensorsclassextension.h)
Il metodo ISensorDriver::OnClientConnect notifica al driver del sensore che un'applicazione client è connessa.
Sintassi
HRESULT OnClientConnect(
IWDFFile *pClientFile,
LPWSTR pwszSensorID
);
Parametri
pClientFile
Puntatore a un'interfaccia IWDFFile che rappresenta l'oggetto file per l'applicazione che richiede la connessione.
pwszSensorID
LPWSTR che contiene l'ID del sensore a cui si connette l'applicazione client.
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.
Osservazioni
L'estensione della classe del sensore chiama questo metodo solo se all'applicazione client specificata è stata concessa l'autorizzazione dall'utente per accedere al driver. Se l'utente revoca questa autorizzazione, l'estensione della classe chiama immediatamente ISensorDriver::OnClientDisconnect per la stessa coppia di applicazioni/sensori.
L'estensione della classe chiama sempre questo metodo prima di chiamare ISensorDriver::OnSetProperties o ISensorDriver::OnGetDataFields per un particolare sensore. È consigliabile mantenere un conteggio dei riferimenti delle applicazioni connesse per prevedere quando sono possibili chiamate a questi tre metodi. Se nessuna applicazione client è connessa, è possibile modificare il comportamento del driver, ad esempio, eseguendo misure per ridurre il consumo di energia.
È possibile usare il valore del puntatore (l'indirizzo a cui punta) fornito da pClientFile come tipo di ID per tenere traccia delle applicazioni connesse. Tuttavia, è necessario tenere traccia separatamente di questi ID per ogni sensore, non per ogni dispositivo, perché l'estensione della classe può fornire lo stesso valore del puntatore a più sensori nello stesso dispositivo.
Per altre informazioni su come usare questo metodo, vedere Filtrare i dati.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | sensorsclassextension.h |
| libreria | SensorsClassExtension.lib |