ISensorClassExtension::P rocessIoControl-Methode (sensorsclassextension.h)
Die ISensorClassExtension::P rocessControl-Methode sendet Windows Portable Devices (WPD)-Steuerungsanforderungen an die Sensorklassenerweiterung zur Verarbeitung.
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, aber nicht beschränkt auf einen der folgenden Werte.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Die Methode war erfolgreich. |
| E_ACCESS_DENIED | Keine Berechtigung. Die E/A-Anforderung hat z. B. Daten angefordert, 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. |
Bemerkungen
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 Standort-API senden nur WPD IOCTLs, die von der Sensorklassenerweiterung immer 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, dass die Sensorklassenerweiterung standardmäßig nicht verarbeitet wird, werden über ISensorDriver::OnProcessWpdMessagean den Treiber gesendet.
Der Treiber darf keine E/A-Steuerungsanforderungen abschließen, die er an die Sensorklassenerweiterung weiterleitet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | sensorsclassextension.h |
| Library | SensorsClassExtension.lib |