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 do sensor para processamento.
Sintaxe
HRESULT ProcessIoControl(
IWDFIoRequest *pRequest
);
Parâmetros
pRequest
Ponteiro para a interface IWDFIoRequest que representa o objeto de solicitação UMDF.
Retornar valor
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 WPD. |
Comentários
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 de classe do 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 WPD, que sempre podem ser processadas pela extensão de classe do sensor.
Depois de processar uma solicitação de controle de E/S, a extensão de classe do 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 do sensor não manipula por padrão são enviadas para o driver por meio de ISensorDriver::OnProcessWpdMessage.
O driver não deve concluir solicitações de controle de E/S que ele encaminha para a extensão de classe do sensor.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | sensorsclassextension.h |
Biblioteca | SensorsClassExtension.lib |