Método ISensorClassExtension::P rocessIoControl (sensorsclassextension.h)
O método ISensorClassExtension::P rocessControl envia solicitações de controle de E/S do WPD (Dispositivos Portáteis do Windows) para a extensão de classe de sensor para processamento.
Sintaxe
HRESULT ProcessIoControl(
IWDFIoRequest *pRequest
);
Parâmetros
pRequest
Ponteiro para a interface IWDFIoRequest que representa o objeto de solicitação UMDF.
Valor de retorno
Esse método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
| S_OK | O método foi bem-sucedido. |
| E_ACCESS_DENIED | Nenhuma permissão. Por exemplo, a solicitação de E/S procurou dados para os quais nenhuma permissão existe. |
| E_POINTER | Um argumento de ponteiro necessário era NULL. |
| HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) | A solicitação não continha um IOCTL do WPD. |
Observações
O UMDF envia solicitações de controle de E/S para drivers de sensor por meio de IQueueCallbackDeviceIoControl::OnDeviceIoControl. Recomendamos que você chame ProcessIoControl para encaminhar todas as solicitações do WPD para a extensão da classe de sensor para processamento. Você pode usar a macro WPD IS_WPD_IOCTL para determinar se um determinado código de controle é específico do WPD. Os clientes da API do Sensor e da API de Localização enviam apenas IOCTLs do WPD, que sempre podem ser processados pela extensão da classe de sensor.
Depois de processar uma solicitação de controle de E/S, a extensão da classe de sensor usa a interface de retorno de chamada do driver, ISensorDriver, para fornecer notificações, conforme apropriado. Solicitações WPD que a extensão de classe de sensor não manipula por padrão são enviadas ao driver por meio de ISensorDriver::OnProcessWpdMessage.
O driver não deve concluir as solicitações de controle de E/S que ele encaminha para a extensão da classe de sensor.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | sensorsclassextension.h |
| biblioteca | SensorsClassExtension.lib |