Metodo ISensorClassExtension::P rocessIoControl (sensorclassextension.h)
Il metodo ISensorClassExtension::P rocessControl invia richieste di controllo I/O di Windows Portable Devices (WPD) all'estensione della classe del sensore per l'elaborazione.
Sintassi
HRESULT ProcessIoControl(
IWDFIoRequest *pRequest
);
Parametri
pRequest
Puntatore all'interfaccia IWDFIoRequest che rappresenta l'oggetto richiesta UMDF.
Valore restituito
Questo metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
| S_OK | Il metodo è riuscito. |
| E_ACCESS_DENIED | Nessuna autorizzazione. Ad esempio, la richiesta di I/O ha cercato dati per cui non esiste alcuna autorizzazione. |
| E_POINTER | Un argomento del puntatore obbligatorio è NULL. |
| HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) | La richiesta non contiene un IOCTL WPD. |
Commenti
UMDF invia richieste di controllo I/O ai driver del sensore tramite IQueueCallbackDeviceIoControl::OnDeviceIoControl. È consigliabile chiamare ProcessIoControl per inoltrare tutte le richieste WPD all'estensione della classe del sensore per l'elaborazione. È possibile usare la macro WPD IS_WPD_IOCTL per determinare se un determinato codice di controllo è specifico per WPD. I client dell'API Sensore e dell'API Location inviano solo IOCTLs WPD, che possono sempre essere elaborati dall'estensione della classe del sensore.
Dopo aver elaborato una richiesta di controllo I/O, l'estensione della classe sensore usa l'interfaccia di callback del driver, ISensorDriver, per fornire notifiche, in base alle esigenze. WPD richiede che l'estensione della classe del sensore non gestisca per impostazione predefinita venga inviata al driver tramite ISensorDriver::OnProcessWpdMessage.
Il driver non deve completare le richieste di controllo di I/O che inoltra all'estensione della classe del sensore.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | sensorclassextension.h |
| Libreria | SensorsClassExtension.lib |