ISensorClassExtension::P rocessIoControl 方法 (sensorsclassextension.h)
ISensorClassExtension::P rocessControl 方法将 Windows Portable Devices (WPD) I/O 控制请求发送到传感器类扩展进行处理。
语法
HRESULT ProcessIoControl(
IWDFIoRequest *pRequest
);
参数
pRequest
指向表示 UMDF 请求对象的 IWDFIoRequest 接口的指针。
返回值
此方法返回 HRESULT。 可能的值包括但不限于以下值之一。
返回代码 | 说明 |
---|---|
S_OK | 方法成功。 |
E_ACCESS_DENIED | 无权限。 例如,I/O 请求会查找不存在任何权限的数据。 |
E_POINTER | 所需的指针参数为 NULL。 |
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) | 请求不包含 WPD IOCTL。 |
注解
UMDF 通过 IQueueCallbackDeviceIoControl::OnDeviceIoControl 向传感器驱动程序发送 I/O 控制请求。 建议调用 ProcessIoControl 将所有 WPD 请求转发到传感器类扩展进行处理。 可以使用 WPD 宏IS_WPD_IOCTL来确定给定控件代码是否特定于 WPD。 传感器 API 和位置 API 的客户端仅发送 WPD IOCTL,这些 IOCTL 始终可由传感器类扩展进行处理。
处理 I/O 控制请求后,传感器类扩展会根据需要使用驱动程序的回调接口 ISensorDriver 来提供通知。 传感器类扩展默认不处理的 WPD 请求将通过 ISensorDriver::OnProcessWpdMessage 发送到驱动程序。
驱动程序不得完成它转发到传感器类扩展的 I/O 控制请求。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | sensorsclassextension.h |
Library | SensorsClassExtension.lib |