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

Confira também

ISensorClassExtension