ISensorClassExtension::P rocessIoControl-Methode (sensorsclassextension.h)
Die ISensorClassExtension::P rocessControl-Methode sendet E/A-Steuerungsanforderungen von Windows Portable Devices (WPD) zur Verarbeitung an die Sensorklassenerweiterung.
Syntax
HRESULT ProcessIoControl(
IWDFIoRequest *pRequest
);
Parameter
pRequest
Zeiger auf die IWDFIoRequest-Schnittstelle, die das UMDF-Anforderungsobjekt darstellt.
Rückgabewert
Diese Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem einer der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Methode wurde erfolgreich ausgeführt. |
| E_ACCESS_DENIED | Keine Berechtigung. Die E/A-Anforderung hat beispielsweise Daten gesucht, für die keine Berechtigung vorhanden ist. |
| E_POINTER | Ein erforderliches Zeigerargument war NULL. |
| HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) | Die Anforderung enthielt keine WPD-IOCTL. |
Hinweise
UMDF sendet E/A-Steuerungsanforderungen an Sensortreiber über IQueueCallbackDeviceIoControl::OnDeviceIoControl. Es wird empfohlen, ProcessIoControl aufzurufen, um alle WPD-Anforderungen zur Verarbeitung an die Sensorklassenerweiterung weiterzuleiten. Sie können das WPD-Makro IS_WPD_IOCTL verwenden, um zu bestimmen, ob ein bestimmter Steuerelementcode FÜR WPD spezifisch ist. Clients der Sensor-API und der Standort-API senden nur WPD-IOCTLs, die immer von der Sensorklassenerweiterung verarbeitet werden können.
Nach der Verarbeitung einer E/A-Steuerungsanforderung verwendet die Sensorklassenerweiterung die Rückrufschnittstelle des Treibers, ISensorDriver, um Benachrichtigungen bereitzustellen. WPD-Anforderungen, die die Sensorklassenerweiterung standardmäßig nicht verarbeitet, werden über ISensorDriver::OnProcessWpdMessage an den Treiber gesendet.
Der Treiber darf keine E/A-Steuerungsanforderungen abschließen, die er an die Sensorklassenerweiterung weiterleitet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | sensorsclassextension.h |
| Bibliothek | SensorsClassExtension.lib |