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

Weitere Informationen

ISensorClassExtension